Introduction
注釈：本資料はAI技術を用いて翻訳されています。
概要
AGS は、開発者が使うすべての環境で動作するよう設計されています。ターミナル、IDE、CI パイプライン、AI アシスタントのいずれでも利用できます。AGS CLI は、これらすべての環境を AGS に接続する単一のツールです。
このレコーディングは、コマンドツリーとヘルプページだけを使って、サービスからリソース、メソッドへと移動する様子を示しています。
決定論的レイヤー
すべての ags コマンドは、AGS API エンドポイントに一対一で対応しています。コマンドを実行すると、CLI はコマンド名とパラメーターが示すネットワーク呼び出しを正確に行います。隠れた副作用はなく、実行後に驚かされるような複合操作もありません。すべてのステップを実行前に確認できます。
チャットインターフェイス単体は、複数ステップのバックエンド変更には適していません。AI は意図の理解や曖昧さの解消に優れていますが、長い状態変更の連鎖を確実に実行することは苦手です。そのため、CLI は実行を決定論的に保ちつつ、アシスタントが意図を処理します。
ワークフロー
ワークフローは、型付き入力、順序付きステップ、明示的なステップ依存関係を持つ YAML ファイルです。あるステップが生成した値は、参照によって次のステップに渡されます。実行前に、ドライランモードでワークフローを実行して、すべての呼び出しとその入力を確認できます。確認するまで何も適用されません。つまり、Portal を何度も訪れる代わりに、ひとつのレビュー済みの実行で機能全体をセットアップできます。
組み込みワークフローと独自ワークフローの作成方法については、ワークフロー を参照してください。
AI と CLI
AI エージェントはワークフローを選択し、必要な入力を埋めることができます。AGS CLI ランタイムはそれらのステップを決定論的に実行します。エージェントが意図を処理し、CLI が実行を担当します。この分離により、エージェントが文書化されていない予期しないアクションを誤って実行することはありません。スキルとアシスタントはワークフローの上位に位置し、言語処理を担当しますが、状態変更は行いません。この役割分担により、ワークフローは人が実行する場合でもエージェントが実行する場合でも同じように動作します。
このパターンの詳細については、Phil Tossell による AccelByte ブログ記事 "Beyond the Chat Box"（2026 年 6 月）を参照してください。