このドキュメントでは、テレフォニー統合用にGoogle Cloud プロジェクトを構成するために必要な手順について説明します。
Google Cloud プロジェクトを選択または作成する
SIP トランクは通信上の理由でのみプロジェクトに接続されますが、その効果は特定のプロジェクトに限定されません。
たとえば、3 つの異なるプロジェクト（開発、テスト、本番環境）を作成できます。すべての SBC から GTP への通信に同じ SIP トランクが使用されている場合、SIP トランクを作成する最初のリクエストのみが成功し、同じリージョンとホスト名で SIP トランクを作成する残りのリクエストは失敗します。
SIP トランクの管理専用に別のプロジェクトを使用することもできます。これにより、別のチームがトランクを管理できます。トランク UI 内で、開発、テスト、本番環境用に異なる SBC グループを確立できます。
Google Cloudが提供するサービスを使用するには、プロジェクトを作成する必要があります。プロジェクトはすべての Google Cloud リソースを整理します。プロジェクトは、共同編集者、有効化された API などのリソース、モニタリング ツール、お支払い情報、認証とアクセス制御で構成されます。1 つのプロジェクトを作成することも、複数のプロジェクトを作成してリソース階層内で Google Cloud リソースを構成することもできます。プロジェクトを作成する際は、プロジェクト ID をメモしてください。API 呼び出しを行うには、この ID が必要です。プロジェクトの詳細については、Resource Manager ドキュメントをご覧ください。
Google Cloud コンソールのプロジェクト セレクタページで、 Google Cloud プロジェクトを選択または作成します。
プロジェクトの選択または作成に必要なロール
- プロジェクトを選択する: プロジェクトを選択する際に、特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
-
プロジェクトを作成する: プロジェクトを作成するには、
resourcemanager.projects.create権限を含むプロジェクト作成者のロール（roles/resourcemanager.projectCreator）が必要です。詳しくは、ロールを付与する方法をご覧ください。
権限
- Google Cloud コンソールで、[IAM と管理] > [IAM] に移動します。
- 既存のサービス アカウントを選択するか、新しいサービス アカウントを作成して、
Dialogflow API Adminロールを割り当てます。このロールは、テレフォニー統合に必要です。
電話番号 API へのアクセス
電話番号 API メソッドを使用するには、特別なアクセス権が必要です。詳しくは、Google 担当者にお問い合わせください。
Dialogflow、会話プロファイル、電話番号を構成する
このセクションでは、関連付けられた Google Telephony Platform（GTP）の電話番号を使用して会話型 AI の会話プロファイルを作成する方法について説明します。
- Colab Enterprise に移動します。プロンプトが表示されたら、Compute Engine、Dataform、Vertex API を有効にします。
- [ノートブックをインポート] を選択し、データソースとして [URL] を選択します。GitHub リポジトリの URL を入力し、[インポート] を選択します。
- [
PROJECT_ID] フィールドに、統合に関連付けるプロジェクトの Google Cloud プロジェクト ID を入力します。Google Cloud コンソールのページ上部にあるメニューで、既存のプロジェクトを確認します。 - 選択したリージョンを
REGIONフィールドに入力します。すべての Dialogflow リージョンがサポートされています。 JWTフィールドをそのままにするか、ここにJWT値を入力します。空白のままにすると、デフォルトで SSO が使用されます。- 上部の [プロジェクト] セクションにある再生ボタンをクリックして、そのセクションのコードを実行します。プロンプトが表示されたら、ノートブックに Google 認証情報へのアクセスを許可します。
- [Configuring Conversational AI for SIP/SIPREC] セクションを開きます。[Create a dummy Dialogflow ES agent...] で、[Show code] をクリックし、変更を加えずにコードを実行します。これにより、ダミーの Dialogflow ES エージェントが作成され、そのティアが Enterprise に設定されます。Dialogflow API エンドポイントにアクセスするには、ダミーの Dialogflow ES エージェントが必要です。各 Google Cloud プロジェクトに設定できる Dialogflow ES エージェントは 1 つだけです。
- 展開して、
ConversationProfileを作成するスクリプト... セクションのコードを表示します。CONVERSATION_PROFILE_NAME: 任意の文字列を指定できます。デフォルト値を使用することも、独自の値を入力することもできます。SECURITY_SETTINGS: 任意の文字列を指定できます。デフォルト値を使用することも、独自の値を入力することもできます。PHONE_NUMBER_COUNTRY_CODE: GTP 電話番号に関連付ける国コードを入力します。CX_AGENT_NAME: 生成された会話プロファイルを関連付ける Dialogflow CX エージェントの名前を入力します。
- コードを実行します。出力には、生成された
ConversationProfileの名前、セキュリティ設定、GTP 電話番号が含まれます。 - Dialogflow ES コンソールに移動して、
Dummy_ES_agentという名前のエージェントが作成されていることを確認します。[設定] をクリックして、エージェントが正しいGoogle Cloud プロジェクトに関連付けられていること、および Essentials エディションにアップグレードされていることを確認します。 - Agent Assist コンソールに移動します。ナビゲーション メニューで [会話プロファイル] をクリックして、入力した
CONVERSATION_PROFILE_NAMEを含む会話プロファイルが作成されていることを確認します。 - Conversational AI Insights コンソールに移動します。Dialogflow CX エージェントに関連付けられているすべての会話の音声文字変換がインポートされていることを確認します。
（省略可）Dialogflow CX Phone Gateway の通話時間の割り当ての増加をリクエストする
Dialogflow ES Essentials と Dialogflow CX のサブスクリプションには、標準の割り当てが用意されています。Dialogflow をまったく使用していない場合（Agent Assist、音声文字変換、通話録音のみを使用している場合など）、デフォルトの割り当ては Dialogflow ES Essentials の割り当てと同じです。
推定トラフィックに基づいて、必要に応じて割り当ての増加をリクエストできます。ほとんどのユースケースでは、標準の割り当てで設定とテストに十分ですが、ランタイム アプリケーションでは割り当てを増やす必要があります。割り当ての詳細と増加をリクエストする手順については、Dialogflow の割り当てページをご覧ください。
（省略可）Dialogflow API の監査ロギングを有効にする
Dialogflow API（dialogflow.googleapis.com）の監査ロギングを有効にして、管理読み取り、データ読み取り、データ書き込みを行うには、この機能を使用して、行われた個々の 会話型 AI API 呼び出しと、認可と使用に使用された認証情報をすべて確認します。これにより、問題のトラブルシューティングとデバッグをより効果的に行うことができます。
次のステップ
- SBC の設定と構成方法を確認する。