self-host-agenta

Agenta のセルフホスト

ユーザーがオープンソース版の Agenta を立ち上げ、そこで動作するエージェントを実行できるよう支援します。 これはガイド付きのセットアップであり、リファレンスの検索ではありません。手順を案内し、最後にテスト済みで動作するエージェントを用意してください。このスキルの対象はオープンソース版です。EE（アクセス制御、SSO、複数組織）の話が出た場合は、その旨を伝えて対応を見送ってください。

公開されている OSS セルフホスト用ドキュメント https://docs.agenta.ai/self-host を、すべてのコマンドの参照元としてください。このページへのリンクを案内し、ここでコマンドを再掲しないでください。リポジトリと、その AGENTS.md、およびこれらのドキュメントはすでに確認できます。明らかなことは推測してください。読めば分かることを説明し直さないでください。簡潔にしてください。

ワークフロー（順番に従ってください）

1. まず要望を理解し、作業を始める前に計画を提案します。 ユーザーが何をしたいのか、どのようにセットアップするか（ローカルマシンかリモートサーバーか）を数文で説明し、確認が必要な選択事項を挙げてください。まだコマンドを実行しないでください。

2. 選択事項を提示してから、質問します。 以下の各選択事項について、背景を一行で説明し、適切なデフォルトを示してください。ハーネスに質問／選択用の UI（AskUserQuestion 形式のツールなど）がある場合は、それを使ってユーザーが選択できるようにしてください。デフォルトがある選択事項は、「変更のご希望がなければ、X をデフォルトとして使用します。」という表現にしてください。選択肢をすべて文章で列挙しないでください。詳細と選択事項ごとのドキュメントリンクについては、resources/decisions.md を参照してください。

3. 計画の承認を得てから実行します。 実際のコマンドは OSS ドキュメントに従ってください（以下のルーティング表を参照）。https://github.com/Agenta-AI/agenta をクローンした作業ツリーから実行してください。run.sh はルートディレクトリからの相対パスを解決します。

4. 段階的にテストし、どこまで行うかユーザーに選んでもらいます。 必ず簡易健全性チェックを実行してください（API のヘルス、ランナーへの接続、サインアップからスタジオへの到達）。次に、さらに進めるかどうかを尋ねてください。選択肢は、簡易機能チェック（プロンプトを一つ実行、数分）またはエンドツーエンドの完全なチェック（ツール呼び出し、永続的なマウント、実行場所の確認、15～20 分程度）です。許可なく、より詳細なテストを実行しないでください。失敗があれば、トラブルシューティングを行って再試行してください。手順：resources/test.md。

5. フォルダーマウントについて伝えます（ローカルサンドボックスのみ）。 セットアップ完了後、ローカルサンドボックスを選択した場合に限り、ホストのフォルダーをマウントするとエージェントからアクセスできることを一文で伝え、エージェントのランタイムをカスタマイズするへのリンクを案内してください。Daytona の場合は省略してください。

6. フィードバックを依頼します。 最後に、または問題が発生したときに、「Agenta チームの改善に役立てるため、匿名のセットアップフィードバックを送信してもよろしいですか？」とユーザーに尋ねてください。同意があった場合に限り送信し、シークレットは絶対に送信しないでください。いずれの場合も、チームが感謝していることを伝えてください。 方法：resources/send-feedback.md。

選択事項（OSS）

ステップ 2 でユーザーと一緒に決定してください。詳細とドキュメントへのリンクは resources/decisions.md を参照してください。

• 実行場所 — ローカルマシン（デフォルト）またはリモートサーバー。
• モデル認証 — マネージドプロバイダーの API キー（どこでも使用可能、デフォルト）、または自身の Claude／Codex サブスクリプション（ローカルのみ）。
• サンドボックス（エージェントコードの実行場所） — ローカル（高速、ランナーコンテナーを共有、信頼できるユーザー 1 人向け。初回のローカルセットアップではデフォルト）、または Daytona（実行ごとに分離され、Daytona API キーが必要）。
• アプリのツールとトリガー（任意） — サードパーティアプリをツールとして接続する場合、またはイベントトリガー（サードパーティアプリからエージェントを起動するもの）を使用する場合、デプロイには Composio が必要です。Composio の無料アカウントと COMPOSIO_API_KEY が必要です。今すぐセットアップするか、スキップするかを尋ねてください。デフォルトはスキップです。組み込みツール、MCP サーバー、スケジュール（時間ベース）トリガーは、これがなくても使用できます。これはスケジュールトリガーとは別のものです。
• 公開方法 — リモートの場合のみ：IP:port で直接公開するか、TLS を使用したドメインで公開するか。

ルーティング表：「Xしたい」→ OSS ドキュメント

目的	ページ
ローカルで初回デプロイする（ポート 80 または任意のポート）	https://docs.agenta.ai/self-host/quick-start
どこから始めるか／自分に当てはまる内容を確認する	https://docs.agenta.ai/self-host/overview
すべての環境変数（runner の変数を含む）	https://docs.agenta.ai/self-host/configuration
ネットワークトポロジー、ポート、コンテナ DNS	https://docs.agenta.ai/self-host/infrastructure/networking
各サービスの連携方法	https://docs.agenta.ai/self-host/infrastructure/architecture
リモートサーバーにデプロイする	https://docs.agenta.ai/self-host/guides/deploy-remotely
TLS を使ってドメインの背後に配置する	https://docs.agenta.ai/self-host/guides/using-ssl
実行が runner に到達する仕組み	https://docs.agenta.ai/self-host/agent-execution/how-agents-run
自分の Claude／ChatGPT サブスクリプションでエージェントを実行する	https://docs.agenta.ai/self-host/use-your-own-subscription
クラウドサンドボックス（Daytona）でエージェントを実行する	https://docs.agenta.ai/self-host/agent-execution/daytona
runner コンテナ内でエージェントをローカル実行する	https://docs.agenta.ai/self-host/agent-execution/run-agents-locally
デプロイに適した安全なサンドボックスを確認する	https://docs.agenta.ai/self-host/agent-execution/sandbox-isolation-and-security
エージェントの実行にバイナリ、依存関係、CPU を追加する	https://docs.agenta.ai/self-host/agent-execution/customize-the-agent-runtime
アプリツール、MCP サーバー、トリガーを接続する	https://docs.agenta.ai/self-host/app-tools-and-triggers

リソース

• resources/decisions.md — 質問項目の詳細：各判断、その背景、デフォルト、変更内容、手順を説明するドキュメントページ。
• resources/test.md — 段階的なテスト：常に実行する健全性チェックと、任意の機能テストおよびエンドツーエンドテスト。
• resources/troubleshoot.md — 実際の環境で確認された、正確なエラーテキストに対応する障害。
• resources/harden.md — パブリックホスト向けの OSS リモート環境のセキュリティ強化。
• resources/send-feedback.md — 任意で、ユーザーの承認を得てセットアップに関するフィードバックを送信する方法。公開トピックです。秘密情報は絶対に含めないでください。

基本ルール

• 正式な情報源はドキュメントです。リソースファイルとドキュメントの内容が異なる場合は、ドキュメントを優先してください。
• ユーザーに案内する前に、すべてのコマンドを確認してください。これらのコマンドは実際のデプロイ環境に対して実行されます。
• 秘密情報（API キー、トークン、パスワード、DB 認証情報）を表示または送信しないでください。