概要
あらゆるコーディングアシスタントを、Google Cloud 上で AI エージェントを作成、評価、デプロイするエキスパートに変えるコマンドラインツールとスキルセットです。スキャフォールディング、評価、デプロイ、オブザーバビリティなどのコマンドを提供し、ADK フレームワークと統合されています。
README プレビュー
\n \n agents-cli\n The CLI and skills for building agents on Gemini Enterprise Agent Platform.\n\n \n Get Started | \n Skills | \n Commands | \n PyPI | \n Issues | \n Docs | \n Release Notes | \n Star us\n \n\n\n---\n\nTurn your favorite coding assistant into an expert at building and deploying agents on Google Cloud.\n\n**Agents CLI in Agent Platform** (`agents-cli`) gives your coding agent the skills and commands to build, scale, govern, and optimize enterprise-grade agents — so you don't have to learn every CLI and service yourself.\n\n**Works seamlessly with:**\n[Antigravity CLI](https://antigravity.google/) • [Claude Code](https://docs.anthropic.com/en/docs/claude-code) • [Codex](https://github.com/openai/codex) • *and any other coding agent.*\n\n## Get Started\n\n**Prerequisites:** Python 3.11+, [uv](https://docs.astral.sh/uv/getting-started/installation/), and [Node.js](https://nodejs.org/en/download).\n\n### 1. Install\n\n```bash\nuvx google-agents-cli setup\n```\n\n\nOr just the skills — your coding agent will handle the rest\n\n```bash\nnpx skills add google/agents-cli\n```\n\n\n\n### 2. Open your coding agent\n\nLaunch [Antigravity CLI](https://antigravity.google/), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), or any coding agent you prefer.\n\n### 3. Build your first agent\n\nAsk your coding agent to build something — e.g. *"Use agents-cli to build a caveman-style agent that compresses verbose text into terse, technical grunts"*\n\nSee the [full tutorial](https://google.github.io/agents-cli/guide/quickstart-tutorial/) for a step-by-step walkthrough.\n\n**[Browse the full documentation →](https://google.github.io/agents-cli/)**\n\n---\n\n## Agent Skills\n\n| Skill | What you
FAQ (5)
トラブル対応Windows で agents-cli setup やその他のコマンドを実行した際に発生する PermissionError [WinError 5] Access denied を修正するにはどうすればよいですか？
この問題は、agents-cli のバージョン 1.9.0 より前で、uv.exe などのツールがディスク上に存在するにもかかわらず、AppLocker、Defender、NTFS のアクセス許可ポリシーなどが原因で Windows によって実行がブロックされる場合に発生します。shutil.which() は Windows 上で実行可能ファイルを見つけますが、実際に実行できるかどうかは検証せず、以前の subprocess ヘルパーは結果として発生する PermissionError をキャッチしていませんでした。
agents-cli を 1.9.0 以降にアップグレードして修正してください:
python -m pip install --upgrade agents-cliインストールを確認します:
agents-cli infoアップグレード後、CLI は生の Python トレースバックではなく、わかりやすいツール解決エラーを報告します。コマンドを正常に実行するには、uv.exe の実行が許可されていることも確認する必要があります:
uv --versionそれでも「Access is denied」が返される場合は、IT 管理者に依頼して AppLocker/Defender で uv.exe を許可するか、許可された場所に uv を再インストールするか、uv がブロックされていない環境で CLI を実行してください。同じ問題は、同じ subprocess ランナーを共有しているため、setup、lint、login、deploy、publish、および scaffold コマンドにも影響する可能性があります。
トラブル対応setup を実行した後でも、なぜ agents-cli info が "Installed skills: none" と表示されるのですか？
これは agents-cli v1.9.0 のバグで、agents-cli info が -g フラグを付けずに npx skills list --json を実行するため、プロジェクトスコープのスキルのみが検出され、グローバルにインストールされたスキル（agents-cli setup によって ~/.agents/skills/ にインストールされるもの）が見落とされます。スキル自体は正しくインストールされています — ls ~/.agents/skills/google-agents-cli-*/SKILL.md または npx -y skills list -g --json で確認してください。このバグは v1.12.0 で修正されているため、CLI をアップグレードしてください: uv tool install google-agents-cli --upgrade（または uvx google-agents-cli@latest setup を再実行）。
トラブル対応なぜAgent Runtimeのデプロイガイドとオブザーバビリティガイドは、デプロイ前に`agents-cli infra single-project`を実行することについて矛盾した指示をしているのですか？
この矛盾はドキュメントのバグであり、agents-cli v1.8.0 で修正されました。次の順序ルールに従ってください：
- **Basic Agent Runtime / Cloud Run:** 直接デプロイしてください。先に infra single-project を実行しないでください。
- **GKE:** 通常どおりデプロイを実行してください。デプロイプロセスが、必要な対象を絞った Terraform を実行します。
- **Terraform 管理のオブザーバビリティ（すべてのターゲット）:** 最初のデプロイの前に agents-cli infra single-project --apply を実行してください。
- **既存のインペラティブなデプロイ:** 所有権を切り替える前に既存のリソースを先にインポートまたは削除しない限り、後から Terraform を適用しないでください。それ以外の場合は、インペラティブな所有権を維持し、オブザーバビリティを手動で構成してください。
インペラティブな Agent Runtime デプロイの後に Terraform を適用すると、2 つ目の Runtime が作成されるか、それが対象になる可能性があります。修正済みの README、マイグレーションガイド、およびスキルドキュメントを利用するには、v1.8.0 以降にアップグレードしてください。
トラブル対応同時に実行される複数の `agents-cli deploy --no-wait` プロセスが、互いの保留中の Agent Runtime オペレーションを上書きするのを防ぐにはどうすればよいですか？
**agents-cli v1.8.0 以降**にアップグレードしてください。このバージョンでは、一意のオーナー ID を使用して deployment_metadata.json をアトミックにクレームし、Runtime の再検証およびリモート送信中にクロスプロセスロックを保持し、クリーンアップ/フィニッシュ操作をオーナー認識型にすることで、v1.3.1 の競合状態が修正されています。
python -m pip install --upgrade agents-cli==1.8.0すぐにアップグレードできない場合は、エージェントプロジェクトごとに 1 つの CLI プロセスのみが実行されるように、デプロイを直列化してください:
flock -n /tmp/my-agent-deploy.lock agents-cli deploy --no-waitCI で並列デプロイジョブを実行しないでください。リモート送信後に結果が不明な状態でプロセスが失敗した場合は、メタデータをクリアするのではなく、操作をフェイルクローズドの state=starting のままにし、手動で整合させてください。
トラブル対応agents-cli がリモート Git テンプレートからスキャフォールドする際に、シンボリックリンクされた共有ファイルが省略され、ImportError が発生するのはなぜですか？
これは agents-cli 1.4.1–1.5.0 におけるリグレッションです。リモートテンプレートのスキャフォールディングで、すべてのシンボリックリンクがセキュリティ警告としてスキップされながらも成功と報告されたため、app/shared -> ../../shared のようなディレクトリが欠落していました。agents-cli 1.7.0 以降にアップグレードし、scaffold コマンドを再実行して、例えば demo/app/shared/config.py のようにターゲットが存在することを確認してください。アップグレードできない場合は、リポジトリ内のシンボリックリンクを物理的にコピーしたディレクトリに置き換え、スクリプトと CI ドリフトチェックで同期を維持してください。local@ テストだけに依存しないでください。pre-copy の際にシンボリックリンクがデリファレンスされるため、リモートテンプレートの障害を隠す可能性があります。