あなたのエージェントのための信頼できる住処。

ワーカーを意思決定から分離する

エージェントがタスクを計画し、キューがワーカーの実行タイミングを制御できます。これにより再試行が可視化され、一時的な API の障害が重複アクションになることを防ぎます。各ジョブに識別子を付与し、重要な状態遷移を記録してください。

ツールを特権として扱う

メール送信、支払い、本番環境への書き込みが可能なプロセスには、調査用ワーカーよりも狭い権限が必要です。サービスアカウントを分離し、ツールごとの権限を設定し、重要な操作には明示的な承認ステップを設けてください。秘密鍵をプロンプトやブラウザからアクセス可能なファイルに置かないでください。

• シークレットはウェブルートとバージョン管理の外に保管する
• 外部 API には利用額とリクエスト数の上限を設定してください
• 不要な個人データを保存せずに監査可能な記録を保持

停止したプロセスを前提に設計する

サービス管理ツールまたはコンテナランタイム、ヘルスチェック、上限付きの再起動ポリシーを使用してください。エージェントは最後の外部アクションを盲目的に繰り返すのではなく、保存された状態から再開する必要があります。プロセスの存在だけでなく、ディスクの増加、キューの経過時間、エラー率を監視してください。

マシンのサイズを適切に設定する

リモートモデルを呼び出すワーカーには、多くの場合、適度な CPU とツール用の十分なメモリが必要です。ブラウザ自動化では、さらに多くの RAM を使用する場合があります。ローカルモデルの推論には、別途メモリとアクセラレータの要件があります。一般的な VPS は、GPU が接続されていることを意味するものではありません。

プロビジョニングワークフローの設計

エージェント連携ワークフローでは、公開プランを確認し、アカウントを登録し、明示的な支出上限の範囲内でサービス注文を準備できます。支払いとサーバー作成には適切な承認が必要です。操作識別子を受け取り、完了状態を待ってから、独自の公開SSHキーでサーバーを管理する必要があります。削除は意図的に行い、必要な結果を保持する必要があります。

せっかちなポーリングではなくイベントで

署名付きWebhookは、決済の確定やライフサイクルの変更を通知できます。次の操作を行う前に、その真正性を検証し、配信の重複を排除し、APIと照合してください。プロバイダーは、エージェントのプライベートSSHキー、ウォレットシード、無制限のモデル認証情報を受け取るべきではありません。

1つのタスクを1つの永続的な操作に

各ジョブに安定した識別子と、キュー待ち、実行中、承認待ち、完了、失敗などの明示的な状態を付与します。外部アクションの結果は、プランナーに確認応答する前に保存します。再起動したワーカーは、端末出力が失われたからといって支払い、メッセージ、本番書き込みを再実行するのではなく、永続化された状態を確認する必要があります。

プロビジョニングツールとホスト型ワーカーは別製品です

VPS は、独自のサービス管理機構と認証情報を用いて顧客のエージェントを継続的に実行できます。ホスティングのコントロールプレーン API や MCP エンドポイントは別の統合です。前者はアプリケーションとしてデプロイできますが、後者には別途リリースされた KoalaVPS コントロールプレーン統合が必要であり、本ドキュメントでは接続されていません。

ワーカー全体の予算を組む

ブラウザ、モデルクライアント、キュー、データベースのためにまとめてメモリを確保してください。API 駆動の小さなワーカーは控えめな CPU で足りる場合がありますが、同時ブラウザセッションは RAM をすぐに使い果たします。マシンのサイズを増やす前に、キューの同時実行数と外部 API の支出上限を設定してください。モデルのサブスクリプション、アクセラレータ、サードパーティの API 枠は暗黙に含まれません。

実用的な運用引き継ぎ

起動コマンド、作業ディレクトリ、保護された環境の場所、再起動ポリシー、キューストレージ、ヘルスチェック、各外部認証情報の所有者を記録します。新しいジョブを安全に停止するアクションと、未完了のジョブを再開する手順も含めます。監視では、遅延や重複した作業だけでなく、停止したプロセスも特定する必要があります。

もう少し明確に。