agent-swarm

agent-swarm のインストールと使用

main ブランチのリポジトリを正とします。このインストール済みスキルはスナップショットであるため、作業を始める前に参照先のファイルを再取得してください。 コマンドやオプションが変更されている場合は、最新の例を使用してください。完了したチェックリスト項目には印を付けてください。任意項目を省略した場合は、その項目と理由を記録してください。

インストール

• 必須：対象を確定します。 ホスト、Compose または Kubernetes、ハーネス、認証情報、エージェント数、プライベートアクセスかパブリックアクセスかを確認します。特別な理由がない限り、Compose の例にあるすべてのエージェントを使用します。これはリファレンスデプロイ（リード 1 台、ワーカー 11 台）です。必要な理由がある場合にのみ削減してください。これらの選択によってリソースとネットワークが決まります。デプロイガイドをお読みください。
• 必須：前提条件を確認します。 Compose には Git、Compose v2 対応の Docker、OpenSSL、curl、jq が必要です。Kubernetes には kubectl、Helm、永続ストレージが必要です。選択したワーカー数に対して十分な容量があることを確認します。Compose の例とチャートの値をお読みください。
• 必須：コンポーネントごとの最小要件を設定します。 .env は最小限に保ちます。起動時の識別情報、認証、暗号化、URL、ハーネスの認証情報を設定します。起動時に不要なサポート対象の値は、システムで検証および再読み込みできるよう、swarm config で設定します。コンポーネントごとの最小要件に記載された 3 つの階層すべてを適用してください。
• 必須：シークレットと永続データを保護します。 API キーを生成し、暗号化キーをデータベースと一緒に保持します。各エージェントには専用の個人用ボリュームが必要です。このボリュームには、初回起動時に生成される UUID が保存されます。ボリュームは識別情報とタスクの復旧を保持し、暗号化キーは暗号化された認証情報を保持します。シークレットの暗号化とコンポーネントごとの最小要件をお読みください。
• 必須、次のいずれかを選択：Compose。 リポジトリをクローンし、.env.docker.example をコピーして、API_KEY とハーネスの認証情報を設定します（エージェント ID は任意です）。その後、サンプルサービスを起動します。例では、実際の環境とボリュームが定義されています。Compose の手順を実行してください。
• 必須、次のいずれかを選択：Kubernetes。 認証情報の Secret を作成し、oci://ghcr.io/desplega-ai/charts/agent-swarm をインストールします。--version でリリースを固定してください。これを省略すると、公開済みの最新チャートが取得されます。イメージタグはチャートの appVersion に従うため、チャートのバージョンを固定します。プールのレプリカ数でワーカー数を調整します。Helm の手順を実行してください。Ingress、ダッシュボード接続、CORS については、Kubernetes と Helmに従ってください。
• 必須：API ボリュームは /app/data にマウントし、決して /app にはマウントしません。 名前付きボリュームは、マウント先にあるイメージのパスを覆います。そのため、/app にマウントすると、バイナリがアップグレードされても、イメージ内の migrations/ と package.json がインストール時の状態のままになります。すると API は、どのマイグレーションでも作成されていないスキーマを照会し、/health は古いバージョンを報告しながら正常な状態を示し続けます。既存のインストールでは、データを一度移動する必要があります。バージョン固定とアップグレードの手順を実行してください。
• 必須：イメージのバージョンを固定します。 Compose では、.env の AGENT_SWARM_VERSION に公開済みのリリースを設定し、API とすべてのエージェントで同じタグが解決されることを確認します。空欄の場合は latest となり、これはリリースではなく、main へのコミットごとに変わります。pull_policy: always を設定していると、バージョンを固定していないスタックは再起動のたびにバージョンが変わる可能性があります。バージョンの固定と /app/data のマウントは相互に補完するものであり、バージョンを固定するだけでは安全にアップグレードできません。バージョン固定とアップグレードの手順を実行してください。
• 必須：動作を検証します。 /health、認証済みの /api/agents、完了済みのタスクを確認します。API が正常であるだけでは、ワーカーがタスクを実行できることの証明にはなりません。API の検証手順を実行してください。
• 任意：agent-fs を同時にデプロイします。 エージェント間で永続的なファイル交換が必要な場合は、共有ファイル、添付ファイル、検索を有効にします。Compose には agent-fs と MinIO が含まれています。Helm では agentFs.enabled で有効にします。agent-fs のデプロイと、最小要件および省略手順をお読みください。
• 任意：別のハーネスを選択します。 認証情報やモデルに応じて、Codex、OpenRouter を使用する pi、または Bedrock を選択します。ハーネスの設定と認証情報の最小要件をお読みください。
• 推奨：HTTPS を追加します。 ホスト型ダッシュボード、OAuth コールバック、Webhook には、パブリック HTTPS API オリジンが必要です。Compose には Caddy の tls プロファイルが用意されており、チャートには cert-manager を簡単に設定する方法があります。HTTPS の手順を実行してください。
• 任意：別のデプロイマネージャーを使用します。 VPS プロキシ、Dokploy、Coolify についてはデプロイガイドを使用してください。systemd についてはDEPLOYMENT.mdを使用してください。オンボーディングウィザードについては、はじめにで説明している代替手段があります。
• 必須：アップグレード前に、データベースと暗号化キーをバックアップします。 マイグレーションは前方にのみ適用されるため、古いタグに戻すことはロールバックにはなりません。ロールバックにはバックアップを使用します。Compose ではアップグレード手順を、Helm ではKubernetes の運用手順を実行してください。
• Kubernetes では推奨：日々の運用について学びます。 アップグレード、プールのスケーリング、認証情報のローテーション、バックアップ、トラブルシューティングの表は、Kubernetes の運用手順に記載されています。
• 任意：バックアップとテレメトリーを追加します。 バックアップは復旧に役立ちます。OpenTelemetry を使用すると、サービスのアクティビティを確認できます。チャートのバックアップ設定とOpenTelemetryをお読みください。

この順序で使用してください

• 必須：HTTP と MCP 経由で API にアクセスします。 HTTP はポート 3013 で /docs と /openapi.json を公開します。MCP は /mcp を使用します。bunx @desplega.ai/agent-swarm connect でコーディングエージェントを接続します。これにより、プロジェクトからスウォームにアクセスできるようになります。API とコーディングエージェントの手順に従ってください。
• 任意：管理 UI を接続します。 https://app.agent-swarm.dev を API に接続するか、apps/ui をローカルで実行します。タスクの確認、エージェントの管理、デプロイの設定に使用します。UI ガイドとローカル UI コマンドをお読みください。
• 任意：まず Slack を有効にします。 Slack を使うと、タスクの受け付け、返信、指示をネイティブに行えます。slack-manifest.json をインポートし、両方のトークンを作成して API を設定したら、ボットに DM を送信します。Slack の手順を実行してください。
• 任意：GitHub または GitLab を有効にします。 リポジトリのイベントを接続すると、エージェントが開発作業に対応できるようになります。GitHub、GitLab、インテグレーションの最低要件をお読みください。
• 任意：その他のインテグレーションを有効にします。 作業に必要なシステムを追加します。Linear、Jira、AgentMail、Kapso、Sentryをお読みください。それぞれの最低要件を適用してください。
• 任意：接続を追加します。 OpenAPI、GraphQL、または MCP サービスを登録すると、スクリプトから外部システムに型付きでアクセスできるようになります。リードまたは「Settings → Connections」から接続を設定します。スクリプト接続をお読みください。追加のインテグレーションには、x ルーター経由で Composioを使用します。
• 任意：さらに活用します。 繰り返し発生する作業にコンテキストや自動化が必要な場合は、永続的な機能を使用します。メモリ、ワークフロー、スケジュール、スクリプト、アプリ、ワーカーのスキルをお読みください。