Commands

Last updated on September 15, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

コマンドは ags <service> <resource> <method> のパターンに従います。各コマンドは AGS API エンドポイントに一対一で対応します。コマンドのパスに示された操作以外の隠れた副作用はありません。

API サーフェスの説明

ags describe

これにより、利用可能なすべてのコマンドとそのパラメーターの機械可読なマップが返されます。AI エージェントはこの出力を使って、コマンドまたはワークフローを選択する前に AGS CLI で何ができるかを把握します。

サーフェスの探索

AGS CLI は 2 つの使用パターンに従います。

ags [FLAGS] <COMMAND> [OPTIONS]
ags [FLAGS] <SERVICE> <RESOURCE> <METHOD> [OPTIONS]

--help はすべてのレベルで動作します。実際に何かを実行せずに、利用可能なものを探索するために使用できます。

ags --help
ags iam --help
ags iam users --help
ags iam users search --help

ags describe はサービス、リソース、またはメソッドで絞り込み、AI エージェントやスクリプトが直接利用できる JSON を返します。

ags describe                       # すべてのサービスを出力
ags describe iam                   # サービス内のリソースを出力
ags describe iam users             # リソース内のメソッドを出力
ags describe iam users search      # メソッドの完全なパラメータースキーマを出力

ags doctor は環境、設定、接続性を確認します。ags completions はお使いのシェル用の補完スクリプトを生成します。

共通オプション

すべての ags コマンドは以下のオプションを受け付けます。

オプション	説明
--format json	出力を人間が読みやすいテキストの代わりに JSON で返します。スクリプトで使用します。
--no-input	インタラクティブなプロンプトを無効にします。CI および非インタラクティブ環境で必要です。

テレメトリー

AGS CLI はデフォルトで匿名の使用データを収集します。このデータはチームがツールを改善するために役立てられます。

オプトアウトするには、コマンドを実行する前に環境変数 DO_NOT_TRACK を設定してください。

macOS および Linux の場合:

export DO_NOT_TRACK=1

Windows (PowerShell) の場合:

$env:DO_NOT_TRACK = "1"