このページでは、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 キャンバスでエージェントを設計して保存します。次のタブを切り替えることができます。
フロー: エージェントのワークフローと制御ロジックを視覚的に表現して、メイン エージェントとサブエージェントを作成します。
エージェントをクリックして、そのエージェントの [詳細] パネルを開きます。[サブエージェントを追加]（+）をクリックしてサブエージェントを追加することもできます。
[詳細] パネルでメイン エージェントとサブエージェントを構成します。
名前: エージェントを識別するための名前を追加します。
説明: エージェントの目的の概要。
カスタム指示: エージェントをガイドするカスタム指示を追加します。
モデル: エージェントを強化するモデルを選択します。
ツール: [ツールを追加]（+）をクリックして、エージェントがタスクを完了するために使用するツールを追加します。詳細については、ツールを設定して追加するをご覧ください。
エージェントを保存するには、キャンバス ヘッダーの [保存] をクリックし、プロンプトに沿って操作します。詳しくは、エージェントを保存するをご覧ください。
[プレビュー] タブ: プレビュー ペインでエージェントとチャットして、その機能と回答をテストします。
[コードを取得] をクリックして、エージェント コードを表示します。エージェントの開発を別の場所で続行する場合は、コードをコピーして、任意のコード エディタに貼り付けることができます。
エージェントが完成したら、Agent Studio から直接デプロイできます。詳細については、Agent Studio からエージェントをデプロイするをご覧ください。
エージェントを保存する
保存されていないエージェントにはまだ ID がないため、エージェントをプレビューまたはデプロイする前に保存する必要があります。エージェントを初めて保存するには:
Agent Studio のキャンバスで、[保存] をクリックします。
[エージェントを保存] ダイアログで、エージェント名を入力します。
[保存] をクリックします。
初回保存後は、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 サーバー: Model Context Protocol（MCP）サーバーに直接接続します。
- 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] ページに移動します。
[リージョン] リストを使用して、デプロイ リージョンでフィルタします。
選択したプロジェクトの一部であるデプロイ済みのエージェントがリストに表示されます。
指定したエージェントの名前をクリックします。エージェントの [指標] ページが開きます。
[プレイグラウンド] タブを選択して、エージェントをテストします。
チャット ペインにテストクエリを入力して、エージェントが正常に実行されることを確認します。
エージェントで使用可能な指標の詳細については、デプロイされたエージェントの指標を表示するをご覧ください。