このページでは、Google Cloud コンソールで Agent Studio を使用する方法の概要について説明します。
Agent Studio は、 Google Cloud コンソール内のローコードのビジュアル デザイナーで、エージェントの開発を簡素化します。エージェントのワークフローを視覚的にマッピングし、レスポンスをリアルタイムでテストし、コードをデプロイまたは移行する前にさまざまな構成を試すことができます。
このドキュメントでは、Agent Studio の概要と、環境の設定、エージェントの作成とテスト、本番環境のランタイムへの直接デプロイの方法について説明します。
環境の設定
Agent Studio を使用する前に、Google Cloudの設定を行ってください。
必要なロールを取得する
Agent Studio を使用するために必要な権限を取得するには、プロジェクトに対する Agent Platform ユーザー （roles/aiplatform.user）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
エージェントを作成する
Agent Studio でエージェントを設計してテストする手順は次のとおりです。
Google Cloud コンソールで、[エージェント] ページに移動します。
[エージェントを作成] をクリックして、新しいエージェントの Agent Studio キャンバスを開きます。
Agent Studio キャンバスでエージェントを設計します。次のタブを切り替えることができます。
フロー: エージェントのワークフローと制御ロジックを視覚的に表現して、メイン エージェントとサブエージェントを作成します。
エージェントをクリックして、そのエージェントの [詳細] パネルを開きます。[サブエージェントを追加]（+）をクリックしてサブエージェントを追加することもできます。
[詳細] パネルでメイン エージェントとサブエージェントを構成します。
名前: エージェントを識別するための名前を追加します。
説明: エージェントの目的の概要。
手順: エージェントをガイドする手順を追加します。
モデル: エージェントを強化するモデルを選択します。
ツール: [ツールを追加]（+）をクリックして、エージェントがタスクを完了できるツールを追加します。詳細については、ツールを設定して追加するをご覧ください。
プレビュー: エージェントを構築しながら、エージェントの機能と回答をテストします。エージェントとチャットして、その機能をテストします。
[コードを取得] をクリックして、エージェント コードを表示します。エージェントの開発を別の場所で続行する場合は、コードをコピーして、選択したコードエディタに貼り付けることができます。エージェントの開発を続行するためのその他のオプションについては、ADK チュートリアルをご覧ください。
エージェントが完成したら、Agent Studio から直接デプロイできます。詳細については、Agent Studio からエージェントをデプロイするをご覧ください。
Agent Studio でツールを設定して追加する
エージェント用に次のツールを構成できます。
Google 検索: エージェントが Google 検索を使用してウェブ検索を実行できるようにします。デフォルトでオンになっています。
URL コンテキスト: エージェントに送信されたプロンプトの URL をモデルで分析できるようにします。デフォルトでオンになっています。
Agent Platform Search データストア: [追加]（+）をクリックすると、エージェントが Agent Search データストアにインデックス登録された情報にアクセスできるようになります。
プロジェクト番号: エージェント検索データストアに関連付けられている Google Cloud プロジェクト番号。プロジェクト番号を確認する。
ロケーション: データストアのロケーション。
データストア ID: 含めるデータの Datastore モード（Datastore）の Firestore ID。データストアと ID のリストを表示します。
コレクション ID: 含めるデータのコレクション ID。データストアとコレクション ID のリストを表示する。データストアにコレクション ID がない場合は、
default_collectionと入力します。
既存のデータストアがない場合は、カスタム検索を始めるを参照してデータストアを作成します。次に、Agent Platform Search へのサービス アカウント アクセス権を付与します。
Google Cloud コンソールで、[IAM] ページに移動します。
[アクセス権を付与] をクリックします。
[新しいプリンシパル] フィールドに、サービス アカウント情報「
service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com」を入力します。[+ ロールを追加] を選択します。[Discovery Engine ユーザー] を検索して選択します。[適用]、[保存] の順にクリックします。
MCP サーバー: [追加]（+）をクリックして、MCP サーバーに接続して MCP ツールを追加します。
MCP の表示名: MCP サーバーの名前を入力します。
エンドポイント URL: MCP サーバーのエンドポイント URL を入力します。
認証: なしとして自動入力されました。Agent Studio は、認証を必要としない MCP サーバーのみをサポートしています。
エージェントは、接続された MCP サーバー内のすべてのツールを使用できます。
Agent Studio からエージェントをデプロイする
エージェントを作成してプレビューしたら、本番環境にデプロイできます。Agent Studio からエージェントをデプロイする手順は次のとおりです。
[エージェント] リストページで、デプロイするエージェントをクリックします。選択したエージェントの [エージェントの詳細] ページが表示されます。
[デプロイ] をクリックして、[Agent Runtime インスタンスにデプロイ] ダイアログを開きます。
（省略可）エージェントの表示名または説明を編集します。
使用可能なリージョンのリストからデプロイ リージョンを選択し、[OK] をクリックします。
[デプロイ] をクリックします。
デプロイでは新しいランタイム インスタンスが作成されます。完了までに最大 5 分かかることがあります。成功すると、Agent Studio キャンバスの [フロー] タブにメッセージが表示されます。これで、エージェントが本番環境で使用できるようになり、外部アプリと安全に統合できます。
デプロイされたエージェントを表示する
デプロイしたエージェントを表示するには:
Google Cloud コンソールで、[Agent Platform] ページに移動します。
[リージョン] リストを使用して、デプロイ リージョンでフィルタします。
選択したプロジェクトの一部であるデプロイ済みのエージェントがリストに表示されます。
指定したエージェントの名前をクリックします。エージェントの [指標] ページが開きます。
エージェントで使用可能な指標の詳細については、デプロイされたエージェントの指標を表示するをご覧ください。