このページでは、電話統合用に 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 ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
-
プロジェクトを作成する: プロジェクトを作成するには、プロジェクト作成者ロール
（
roles/resourcemanager.projectCreator）が必要です。これにはresourcemanager.projects.create権限が含まれています。詳しくは、ロールを付与する方法をご覧ください。
権限
- コンソールで、[IAM と管理] -> [IAM] に移動します。 Google Cloud
- 既存のサービス アカウントを選択するか、新しいサービス アカウントを作成して、
Dialogflow API Adminロールが割り当てられていることを確認します。このロールは電話統合に必要です。
Phone number API へのアクセス
Phone number API メソッドを使用するには、特別なアクセス権が必要です。 詳細については、Google 担当者にお問い合わせください。
Dialogflow、会話プロファイル、電話番号を構成する
このセクションでは、関連付けられた Google Telephony Platform（GTP）電話番号を使用して、 会話型 AI 会話プロファイルを作成する手順について説明します。
- Colab Enterprise に移動します。 プロンプトが表示されたら、Compute Engine、Dataform、Vertex API を有効にします。
- [ノートブックをインポート] をクリックし、データソースとして [URL] を選択します。 この GitHub リポジトリの URL を入力し、 [IMPORT] をクリックします。
- [
PROJECT_ID] フィールドに、統合に関連付けるプロジェクトのプロジェクト ID を入力します。 Google Cloud 既存のプロジェクトは、Cloud Console のページ上部のプルダウン メニューに表示されます。 - [
REGION] フィールドに、選択したリージョンを入力します。すべての Dialogflow リージョンがサポートされています。 - [
JWT] フィールドはそのままにするか、ここにJWT値を入力します。空白のままにすると、デフォルトで SSO が使用されます。 - 上部の [プロジェクト] セクションの再生ボタンをクリックして、そのコードセクションを実行します。プロンプトが表示されたら、ノートブックが Google 認証情報にアクセスできるようにします。
- [SIP/SIPREC 用に 会話型 AI を構成する] セクションを開きます。[Create a dummy Dialogflow ES agent...] で [コードを表示] をクリックし、変更せずにコードを実行します。これにより、ダミーの Dialogflow ES エージェントが作成され、階層が Enterprise に設定されます。Dialogflow API エンドポイントにアクセスするには、ダミーの Dialogflow ES エージェントが必要です。各 Google Cloud プロジェクトには、 1 つの Dialogflow ES エージェントを設定できます。
- [Script to create a
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の会話プロファイルが作成されていることを確認します。 - 会話型 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 の設定と構成の方法を確認する。