1. 始める前に
このセルフペースの Codelab では、Google Cloud の Vertex AI Agent Builder を使用して AI エージェントを構築する方法について説明します。各ステップでは、特定のエージェント ビルダー機能とその目的について説明します。
前提条件
- Google Cloud の生成 AI に関する基礎知識
- AI エージェントのコンセプトに関する基本的な知識
学習内容
- Vertex AI Agent Builder を使用してシンプルな AI エージェントを作成する方法
- データストアをアタッチして、作成したエージェントをグラウンディングする方法
必要なもの
- 好奇心
- 動作するパソコンと安定した Wi-Fi 接続
- 課金が関連付けられている Google Cloud プロジェクト
2. 最初の AI エージェントを設計する
これで、独自の AI エージェントを作成する準備が整いました。ただし、開発に着手する前に、エージェントの明確なビジョンを確立することが重要です。次の重要な質問を自問してください。
- 解決される問題タスクの自動化、情報の提供、エンターテイメントの提供、創造的な探索の促進など、
- 主な機能は何ですか？タスクを実行するのか、タスクを委任するのか。テキストを生成しますか、それとも異なるメディアを組み合わせて生成しますか？
- 制限事項すべてを自動で行うことができますか？
- どのような性格やペルソナにすべきか？フォーマル、カジュアル、ユーモラス、役に立つ、情報提供のいずれにするか
- 成功指標は何か。エージェントの有効性をどのように測定しますか？
手続きを迅速に進めるため、本日作成する旅行代理店に関する以下の質問に回答してください。
- 解決される問題
- 旅行の計画は時間がかかり、負担になることがあります。この旅行代理店は、ユーザーが旅行先を見つけ、旅行プランを計画し、フライトと宿泊施設を予約するのに役立ちます。
- 主な機能は何ですか？
- エージェントは以下のことができる必要があります。
- 渡航先に関する質問（ビザ要件など）に回答する
- ユーザーのスケジュールと目的に合った旅行プランを計画する
- フライトと宿泊施設を予約する
- 制限事項
- エージェントがデフォルトで複雑なクエリに回答できない場合があります
- エージェントは視覚的な画像を生成できません
- エージェントの知識は、基盤となるモデルによって制限されます
- どのような性格やペルソナにすべきか？
- このエージェントには、知識が豊富で親切で、旅行に意欲的であることが求められます。情報を明確かつ簡潔に伝えられる必要があります。
- 成功指標は何か。
- このエージェントの成功は、ユーザーがおすすめ（探索、計画、予約）にどの程度満足しているかによって測定できます。
3. Vertex AI Agent Builder を使用した AI エージェントの構築
Vertex AI Agent Builder を使用すると、AI エージェントを数ステップで作成できます。
ステップ 1:
- Vertex AI Agent Builder に移動してください。
- ウェルカムページが表示されます。
- [CONTINUE AND ACTIVATE THE API] ボタンをクリックします。
ステップ 2:
- [App Creation] ページにリダイレクトされます。
- [CREATE A NEW APP] ボタンをクリックします。
ステップ 3:
- 次のページで [エージェント] を選択します。
ステップ 4:
- 表示名を選択します（例: 旅行仲間）
- [リージョン] として [グローバル] を選択します。
- [同意して作成] ボタンをクリックします。
ステップ 5:
- エージェント名を選択します（例: 情報エージェント）
- 目標を追加する（例: 顧客が旅行関連の質問に答えられるようサポートする）
- 指示を定義する（例: ユーザーに挨拶し、今日はお客様をどのようにサポートできるかを尋ねる）
- すべてが確定したら [保存] を押します。
ステップ 6:
- 作成したエージェント（情報エージェントなど）を選択します。
- エージェントの基盤となる生成 AI モデルを選択します（例: gemini-1.5-flash）。
- エージェントと会話してテストします（[ユーザー入力を入力] テキスト ボックスに何か入力します）。
これで、Vertex AI Agent Builder を使用して AI エージェントを作成できました。
4. エージェントにデータストアを接続する
ワカンダへのアクセスについてエージェントに質問すると（「ワカンダへの最適なアクセス方法を教えてください」など）、次のような回答が返されます。
これは事実上正しい情報ですが、「情報を提供できません」とだけ言って会話を終了するのではなく、エージェントが類似する場所を提案すると、ユーザーにとってより有益です。このアプローチにより、ユーザーがエージェントを通じて実際に旅行を予約する可能性があります。
エージェントが類似の場所をおすすめできるようにするには、Datastores を使用してエージェントに詳細情報を提供します。エージェントが組み込みの知識に基づいてユーザーの質問に回答できない場合に、エージェントが参照する追加のナレッジベースとして機能します。
データストアの作成は簡単です。[エージェントの基本] ページの下部にある [+ データストア] ボタンをクリックします。
次の画面で、次の情報を入力します。
- ツール名: 代替の場所
- タイプ: データストア
- 説明: ユーザーのリクエストに存在しない場所が含まれている場合は、このツールを使用します。
完了したら [保存] をクリックします。これにより、エージェントがデータストアと通信するためのデータストア ツールが作成されますが、情報を含む実際のデータストアを作成する必要があります。これを行うには、[データストアを作成] をクリックします。
検索と会話のデータストアを米国リージョンに配置することに同意するよう求めるポップアップが表示されることがあります。続行する場合は、[AGREE] ボタンをクリックします。
データストアの作成を続行し、[会社名] フィールドに入力（例: Travel Wise）して、[続行] をクリックします。
[データストアを作成] をクリックし、[Cloud Storage] を選択します。
ステップが完了したら、
- [非構造化ドキュメント（PDF、HTML、TXT など）] を選択します。
- [ファイル] をクリックします。
- セルに「ai-workshops/agents/data/wakanda.txt」と入力します。
- [続行] ボタンをクリックします。
提供されたテキスト ファイルの内容は次のとおりです。
ワカンダに似た場所
- 南アフリカのオリビ峡谷: 岩の形成がワカンダの戦士の滝を彷彿とさせます。
- イグアスの滝: アルゼンチンとブラジルの国境に位置する巨大な滝。ウォーリアー フォールの主なインスピレーションとなっています。
- ワカンダの文化に浸る: 『ブラックパンサー』のコミックを読んだり、映画を観たり、オンライン リソースを調べたりして、ワカンダの文化、言語、技術について学びましょう。
- ディズニーのテーマパークに行く: ワカンダ専用のエリアはまだありませんが、ディズニーランドやディズニー クルーズの「Marvel Day at Sea」でブラックパンサーに会えるかもしれません。
次のページでデータストアに名前（Wakanda Alternative など）を付け、[作成] をクリックします。
最後の手順として、作成したデータソースを選択し、[作成] をクリックします。
問題がなければ、[利用可能なデータストア] ページに作成されたデータストアが表示されます。
データストア（この場合は Wakanda Alternative）をクリックすると、データストアに含まれるドキュメントなど、データストアの詳細が表示されます。
[エージェントの基本] ページに戻り、[すべてのツールを管理 ] をクリックします。
前に作成した [データストア] をクリックします。
[データストア] セクションに新しい設定が追加されます。これらの新しい設定がすぐに表示されない場合は、データストアが Google Cloud Storage からデータを取り込み中です。5 分以内に完了する見込みです。
- リンクするデータストアを選択します（Wakanda Alternative など）。
- エージェントが幻覚を見ないようにするには、設定を [非常に低い] に設定します。これにより、エージェントが虚偽の情報を生成することをより厳しく制限します。
- 編集が完了したら、ページの上部にある [保存] ボタンをクリックします。
[エージェントの基本] ページに戻り、データストア（代替ロケーションなど）をオンにして、ページ上部の [保存] ボタンをクリックします。
もう少しで完了です。最後のステップとして、エージェント向けの手順に「代替の場所」ツールを含めます。エージェント向けの手順に、- ユーザーのリクエストに存在しない場所が含まれている場合は、${TOOL: 代替の場所} を使用してくださいという行を追加します。
手順のボックスの枠線が赤くなることがありますが、問題ありません。ページ上部の [保存] ボタンをクリックして、エージェントの保存プロセスを開始します。
エージェントの設定を保存したら、ワカンダへのアクセスについてエージェントに再度質問してみてください（「ワカンダへの最適なアクセス方法を教えてください」など）。次のような異なる回答が返されます。
これで、テキスト ファイルから提供された情報を使用して、エージェントがおすすめの場所を提案するようになりました。