GSP002

概要

ほとんどの企業は、プロジェクト開発と生産サイクルのさまざまなフェーズを経験します。これらのプロジェクトを効果的に維持するには、バージョンと環境を管理するためのシステムとプロセスが必要です。Conversational Agents は、複数のバージョンを管理し、特定のバージョンを専用の環境に読み込むためのツールを UI 内に用意しているため、さまざまな目的（およびおそらくさまざまなチーム）で使用できます。このラボでは、会話型エージェントのバージョンと環境の管理について学びます。

Conversational Agents に関するバージョンと環境の定義は次のとおりです。

• バージョン: 開発サイクルの終了時に、仮想エージェントを停止することで、QA サイクルを通過させて、その後恐らく本番環境に移行させるのが一般的です。エージェントを停止するたびに、バージョンを作成し、その番号と説明を加えて完成させます。
• 環境: 開発サイクル中に、さまざまなチームがさまざまなバージョンにアクセスする必要性が生じることがあります。また、本番環境には、次の更新まで変更されない QA 済みのバージョンが必ず存在します。ビジネスが大規模な場合は、独自の仮想エージェントを持つ独立した事業部門があるかもしれません。さまざまな環境を作成し、各チームがアクセスする必要があるバージョンを読み込むことができます。デフォルトでは、Conversational Agents のユーザー インターフェースを使用してエージェントに対するすべての変更を加える作業環境（Draft）があるので、ご注意ください。Draft 環境で変更した仮想エージェントを別の環境に読み込むには、まずそのバージョンを確立する必要があります。

目標

このラボを修了した受講者ができるようになることは、次のとおりです。

• 仮想エージェントのバージョンを作成する。
• 仮想エージェントを公開する環境を作成する。
• 保存した仮想エージェントのバージョンを環境に読み込む。
• 環境に読み込むバージョンを変更する。

前提条件

このラボでは、「Conversational Agents: ボット構築の基本」で開発した基本的なフライト予約エージェントを使用します。なお、テスト シミュレータの使用方法や、インテント、フロー、ページの仕組みなど、Conversational Agents の基本的な知識があることを前提としています。

設定

[ラボを開始] ボタンをクリックする前に

こちらの説明をお読みください。ラボには時間制限があり、一時停止することはできません。タイマーは、Google Cloud のリソースを利用できる時間を示しており、[ラボを開始] をクリックするとスタートします。

このハンズオンラボでは、シミュレーションやデモ環境ではなく実際のクラウド環境を使って、ラボのアクティビティを行います。そのため、ラボの受講中に Google Cloud にログインおよびアクセスするための、新しい一時的な認証情報が提供されます。

このラボを完了するためには、下記が必要です。

• 標準的なインターネット ブラウザ（Chrome を推奨）

注: このラボの実行には、シークレット モード（推奨）またはシークレット ブラウジング ウィンドウを使用してください。これにより、個人アカウントと受講者アカウント間の競合を防ぎ、個人アカウントに追加料金が発生しないようにすることができます。

• ラボを完了するための時間（開始後は一時停止できません）

注: このラボでは、受講者アカウントのみを使用してください。別の Google Cloud アカウントを使用すると、そのアカウントに料金が発生する可能性があります。

ラボを開始して Google Cloud コンソールにログインする方法

1. [ラボを開始] ボタンをクリックします。ラボの料金をお支払いいただく必要がある場合は、表示されるダイアログでお支払い方法を選択してください。 左側の [ラボの詳細] ペインには、以下が表示されます。

   • [Google Cloud コンソールを開く] ボタン
   • 残り時間
   • このラボで使用する必要がある一時的な認証情報
   • このラボを行うために必要なその他の情報（ある場合）

2. [Google Cloud コンソールを開く] をクリックします（Chrome ブラウザを使用している場合は、右クリックして [シークレット ウィンドウで開く] を選択します）。

   ラボでリソースがスピンアップし、別のタブで [ログイン] ページが表示されます。

   ヒント: タブをそれぞれ別のウィンドウで開き、並べて表示しておきましょう。

   注: [アカウントの選択] ダイアログが表示されたら、[別のアカウントを使用] をクリックします。

3. 必要に応じて、下のユーザー名をコピーして、[ログイン] ダイアログに貼り付けます。

   {{{user_0.username | "Username"}}}

   [ラボの詳細] ペインでもユーザー名を確認できます。

4. [次へ] をクリックします。

5. 以下のパスワードをコピーして、[ようこそ] ダイアログに貼り付けます。

   {{{user_0.password | "Password"}}}

   [ラボの詳細] ペインでもパスワードを確認できます。

6. [次へ] をクリックします。

   重要: ラボで提供された認証情報を使用する必要があります。Google Cloud アカウントの認証情報は使用しないでください。 注: このラボでご自身の Google Cloud アカウントを使用すると、追加料金が発生する場合があります。

7. その後次のように進みます。

   • 利用規約に同意してください。
   • 一時的なアカウントなので、復元オプションや 2 要素認証プロセスは設定しないでください。
   • 無料トライアルには登録しないでください。

その後、このタブで Google Cloud コンソールが開きます。

注: Google Cloud のプロダクトやサービスにアクセスするには、ナビゲーション メニューをクリックするか、[検索] フィールドにサービス名またはプロダクト名を入力します。

タスク 1. Conversational Agents の利用を開始する

このタスクでは、Conversational Agents にログインし、新しい仮想エージェント Flight Booker - Env Mgt を作成します。

前提条件: 以下の手順に進む前に、Google Cloud にログイン済みであること。

1. 新しいシークレット ウィンドウで、[Conversational Agents] ページに移動します。

2. [Select Project] ダイアログで、[All] タブをクリックします。

3. プロジェクト ID（）をクリックします。

4. [Google Dialogflow API] ダイアログで、[Enable API] をクリックして続行します。

5. [Agents] ウィンドウで、[Create agent] をクリックします。

6. [Build your own] をクリックします。

7. [Create agent] ダイアログで、次のフィールドを設定します。

   フィールド	値
   表示名	Flight Booker - Env Mgt
   ロケーション
   タイムゾーン	選択したロケーションに適用する GMT オフセットを選択します。
   会話の開始	[Flow] を選択します。

   GMT オフセットを確認するには:
   1. Google Cloud コンソールのタイトルバーで、Gemini AI チャットを開始または終了する（）をクリックします。
   2. [Required API] セクションで、[Enable] をクリックします。
   3. [Start chatting] をクリックし、選択したロケーションの GMT オフセットを尋ねるプロンプトを入力します。

8. [Create] をクリックします。

   エージェントを作成すると、デフォルトの開始フロー ウィンドウが開きます。

9. エージェントを作成したら、[Settings > General > Logging settings] に移動し、[Enable Cloud Logging] と [Enable conversation history] をクリックします。これにより、このエージェントのログが生成されます。

10. [Save] をクリックします。

下の [進行状況を確認] をクリックして、このラボの進捗状況を確認します。

Conversational Agents の概要

タスク 2. .blob 仮想エージェント ファイルをインポートする

前のラボ「Conversational Agents: ボット構築の基本」から仮想エージェントをインポートし、それを使用して環境機能を調べます。

1. 次のリンクをクリックして、サンプルラボ 1 の仮想エージェント ソリューション（gsp929-start-agent）をローカルのハードドライブにダウンロードします。

2. [Agent Overview] ページで、[Export / Restore] ボタンをクリックします。

3. 展開されたメニュー オプションから [Restore Agent] を選択します。

4. [Upload] ラジオボタンを選択します。

5. [select file] をクリックします。

6. ハードドライブにダウンロード済みの gsp929-start-agent.blob に移動して、これを選択します。

7. [Open] をクリックします。

8. [Restore] をクリックします。

必要に応じて、Conversational Agents の「復元」に関するドキュメントを参照してください。

これで、前のラボで完成させたすべてが備わった仮想エージェントができました。

下の [進行状況を確認] をクリックして、このラボの進捗状況を確認します。 .blob 仮想エージェント ファイルをインポートする

タスク 3. Draft 環境でのテスト

1. エージェントをテストするには、右上の [Toggle Simulator] をクリックしてシミュレータを開きます。

2. [Environment] プルダウンがあることに注目してください。

   デフォルトでは、他の環境をまだ作成していないため、このプルダウンに [Draft] が表示されます。

3. [Start Resource] の 2 つ目のプルダウンがあることに注目してください。

   デフォルトでは、他のフローが存在しないため、このプルダウンに [Flow] が表示されます。[Default Start Flow] を選択することもできますが、現時点では必要ありません。

4. [Talk to agent] ボックスに「I want to book a flight」と入力します。

   エージェントからの次の回答は、「What city would you like the flight to depart from?」である必要があります。

5. 会話の上部に表示されている Flow: Default Start Flow というデータに注目してください。

   この点について、前のラボを完了する際に、いくつか気がついていたかもしれません。このラボを進めるにあたっては、プルダウンで選択されている内容をよく確認する必要があります。

下の [進行状況を確認] をクリックして、このラボの進捗状況を確認します。 Draft 環境でテストする

タスク 4. 環境を作成する

1. 左側で [Environments] を選択します。

2. [+ Create] をクリックして、新しい環境を作成します。

3. [Display Name] に「QA」と入力します。

4. [Save] をクリックします。

注: 「Version must be provided for start flow resource.」というメッセージが表示されます。なぜだと思いますか？

ここまでは、デフォルトの開始フローの公開バージョンも、その他のフローも作成していません。デフォルトの開始フローの横の [Version] の下にあるプルダウン リストの唯一の項目が [Not published] であることに注意してください。

Conversational Agents では、環境に公開する開始フローが少なくとも 1 つ必要です。エージェントのバージョン（開始フローを含みます）を公開すると、Conversational Agents でこのエラーが発生しなくなります。

6. [x] をクリックして、環境作成のエラー メッセージを閉じます。

7. メインメニューで [Versions] を選択します。

8. [Flows] タブで [Default Start Flow] をクリックします。

9. [+ 作成] をクリックして、フローのバージョンを作成します。

10. [Display name] フィールドに「Flight booker main v1 chat bot」と入力します。

11. このバージョンの仮想エージェントに含まれる内容の説明を、[description] ボックスに入力します。

12. [Save] をクリックします。

[Versions] リストに [Default Start Flow] があり、[# versions] が 1 になっているはずです。

13. ステータスが [Not ready] または [Ready] と表示されていることを確認します。

14. [Environments] を選択して、新しい環境の構成を再試行します。

15. [+ Create] をクリックします。

16. [Display Name] に「QA」と入力します。

17. [Flow] セクションで、[Default Start Flow] の横にある [Version] プルダウン リストから [Flight booker main v1 chat bot] を選択します。この選択肢が先ほどのプルダウンにはなかったことを思い出してください。

18. [Save] をクリックします。

注: 次のようなメッセージが表示される場合があります。

Version 'projects/qwiklabs-gcp-03-407df58d36b0/locations///agents/e2779218-b813-4844-a0ea-ec2ef504636d/flows/00000000-0000-0000-0000-000000000000/versions/1' is not ready to serve because its training is RUNNING.トレーニングが完了するまで待つか、トレーニングが失敗した場合はバージョンを修正します。

これは、Conversational Agents がバージョニング済みエージェントのキャプチャとトレーニングをまだ実行中であることが原因です。バージョン作成のステータスが [Not ready] であったかどうかを覚えていますか？バージョンの作成ステータスが [Ready] に変わるまでしばらく待ってから、もう一度保存してみてください。

最終更新日とともに、新しい QA 環境がリストに表示されます。

タスク 5. 新しい環境でテストする

次に、作成した環境で、バージョニング済みの仮想エージェントをテストできます。

1. エージェントをテストするには、右上の [Toggle Simulator] をクリックしてシミュレータを開きます（まだ開いていない場合）。

2. 以前のテストのシミュレータがある場合は、[Test Agent] ペインの [Reset conversation] ボタンをクリックします。

3. [Environment] プルダウンから [QA] を選択します。

注: QA 環境が表示されない場合は、ページを更新してみてください。 注: この手順は、特定の環境で特定のバージョンをテストするために重要です。この手順に従わないと、予期しないものをテストすることになる可能性があります。

4. [Talk to agent] ボックスに「i want to book a flight」と入力します。

   これは、さまざまな環境でテストケースを実行する方法の一つです。しかし、QA に読み込まれたバージョンが　Draft と同じであれば、テストの結果も同じになるのではないかと思われるかもしれません。おっしゃるとおりです。次に、よりわかりやすくするために変更を加えます。

下の [進行状況を確認] をクリックして、このラボの進捗状況を確認します。 QA 環境でテストする

タスク 6. 追加のバージョンを作成する

次に、仮想エージェントに変更を加え、新しいバージョンとして保存して、新しい環境に読み込みます。

1. メインメニューから [Flows] タブをクリックします。

2. [Ticket information] ページをクリックします。

3. [Edit fulfillment] をクリックして、エントリーのフルフィルメント情報を編集します。

4. 回答を追加するには、[+Add dialogue response] をクリックし、[Agent responses] の下にある [Agent dialogue] を選択します。[Enter Agent Dialogue] ボックスに、プロンプト「I'll be happy to assist you with that.」と入力します。

5. [Add] をクリックして、[Save] をクリックします。

   この時点で、変更は作業中の Draft に保存されています。次に、この変更を含む仮想エージェントの新しいバージョンを作成します。

6. [Versions] に戻ります。

7. [Flows] タブで、[Default Start Flow] をクリックして、新しいバージョンの作成プロセスを開始します。

8. 上記のバージョニング手順を繰り返して、「Flight booker main v2 chat bot」という Default Start Flow の新しいバージョンを作成します。

9. 「Version 2 adds a friendly getting before prompting for flight details」などの説明を追加します。

10. [Save] をクリックします。

[Versions] リストの [Default Start Flow] のバージョンが「2」に変わっていることを確認します。

タスク 7. 追加の環境を作成する

1. 上記の手順を繰り返して、Default Start Flow の新しいバージョン 2 を使用する「Dev」という新しい環境を作成します。

2. [Version] のプルダウンから [Flight booker main v2 chat bot] を選択します。

3. [Save] をクリックします。

注: 次のようなエラーが再び発生する可能性があります。その場合は、しばらく待ってからもう一度保存してみてください。

Version 'projects/qwiklabs-gcp-00-fe6cab958249/locations//agents/6792c492-5f79-4ccf-8f17-e757b34f38b9/flows/00000000-0000-0000-0000-000000000000/versions/2' is not ready to serve because its training is RUNNING.トレーニングが完了するまで待つか、トレーニングが失敗した場合はバージョンを修正します。

これで、フローの最新バージョンが開発環境に読み込まれました。

次に、シミュレータに戻って、新しいバージョンである Flight booker main v2 chat bot をテストします。

4. [Test Agent] ペインを開きます（まだ開いていない場合）。

5. Test Agent ペインに以前のテストのシミュレータが表示されている場合は、[Reset conversation] ボタンをクリックします。

6. [Environment] プルダウンから [Dev] を選択します。

注: 開発環境が表示されない場合は、ページを更新してみてください。

7. [Talk to agent] ボックスに「i want to book a flight」と入力します。

   エージェントから「I'll be happy to assist you with that.」という回答があります。次に、出発都市の入力が求められます。これは、エージェントの v2 バージョンが実行されていることを示しています。

下の [進行状況を確認] をクリックして、このラボの進捗状況を確認します。 開発環境でテストする

理解度チェック（任意）

タスク 8. さまざまな環境を管理する

これで 2 つの環境を作成し、それぞれに異なるバージョンを読み込みました。これらの環境のいずれかに読み込まれたバージョンを変更する必要がある場合はどうでしょうか。

1. 必要に応じて、左側のペインで [Environments] をクリックして、QA 環境と開発環境の両方のビューに移動します。

2. [QA] 環境をクリックします。

3. バージョンのプルダウンから [Flight booker main v2 chat bot] を選択します。

4. [Save] をクリックします。

5. バージョンの [最終更新] 時刻を確認します。

6. テスト シミュレータを使用して、バージョン 2 が読み込まれていることを確認します（このファイルには、親しみやすい挨拶を追加しました）。新しいテストシナリオを開始するには、[Reset conversation] をクリックし、[Environment] プルダウンで [QA] を選択してください。

7. 戻って、「Flight booker main v1 chat bot」を QA 環境に読み込みます。

8. 再テストします。期待したとおりの内容でしたか。出発都市の入力が求められる前に表示されていた親しみやすい挨拶は表示されなくなります。

作業環境について話し合ってください。Draft 環境を使用してテスト シミュレータを実行した場合、エージェントのどのバージョンがテストされると思いますか？おわかりのとおり、最近保存またはアップロードした作業コピーです。仮想エージェントの作業コピーは、バージョンを作成する準備が整うまで Draft でテストできます。その時点で、別の環境に保存して、別のチームがその停止しているバージョンのテストを開始できるようにします。

特定の環境を選択すると、テストでは、指定した環境に読み込まれた仮想エージェントのバージョンが実行されます（これは、Conversational Agents で Draft モードで現在作業しているバージョンとは異なる場合があります）。もう一つのメリットは、モデルの再トレーニング（より大規模で複雑な仮想エージェントの場合、時間がかかることがあります）のプロセスを経ることなく、さまざまなバージョンをテストできることです。

理解度をチェックする

ログアウトする前に、必要に応じて仮想エージェントをエクスポートできます。これは、次の一般的な手順で行われます。

1. 上部にある [Agent] プルダウンから [View all agents] を選択します。

2. コンテキスト メニュー（縦に 3 つ並んだ点）をクリックし、[Export] を選択します。

3. [Download] ラジオボタンをクリックします。

4. [Export] をクリックします。

お疲れさまでした

これで、仮想エージェントのさまざまなバージョンを管理し、さまざまな環境でテストを実行できるようになりました。

Google Cloud トレーニングと認定資格

Google Cloud トレーニングと認定資格を通して、Google Cloud 技術を最大限に活用できるようになります。必要な技術スキルとベスト プラクティスについて取り扱うクラスでは、学習を継続的に進めることができます。トレーニングは基礎レベルから上級レベルまであり、オンデマンド、ライブ、バーチャル参加など、多忙なスケジュールにも対応できるオプションが用意されています。認定資格を取得することで、Google Cloud テクノロジーに関するスキルと知識を証明できます。

マニュアルの最終更新日: 2025 年 7 月 21 日

ラボの最終テスト日: 2025 年 7 月 21 日

Copyright 2025 Google LLC. All rights reserved. Google および Google のロゴは Google LLC の商標です。その他すべての企業名および商品名はそれぞれ各社の商標または登録商標です。