このページは Cloud Translation API によって翻訳されました。

カスタムセクションによる要約

カスタムセクションを使用した要約では、LLM を使用してカスタマーサービスの会話を要約します。モデルは、会話とカスタムセクション（モデルが実行するタスクを定義するテキストプロンプトの一部）を入力として受け取り、要約を生成します。

利用可能なリージョン

リージョン ID	カスタムセクションを使用した Summarization v4.0	カスタムセクションを使用した Summarization v3.1/3.0	カスタムセクションを使用した要約 v2.1	カスタムセクションを使用した Summarization v2.0/v1.0
`us-central1`	✓	✓	✓	✓
`us-east1`	✓	✓	✓	✓
`us-west1`	✓	✓	✓	✓
`us`	✓	✓	✓
`northamerica-northeast1`	✓	✓	✓
`europe-west1`	✓	✓	✓
`europe-west2`	✓	✓	✓
`europe-west3`	✓	✓	✓
`asia-southeast1`	✓	✓	✓
`asia-northeast1`	✓	✓	✓
`asia-south1`	✓	✓
`australia-southeast1`	✓	✓	✓
`global`	✓	✓	✓	✓

カスタムセクションで独自の要約タスク定義を作成することもできます。

事前定義されたセクション

この機能には 6 つの事前定義済みセクションがあり、次のものを選択できます。

状況: お客様がサポートを必要としていることや、質問があること。簡潔な要約をカスタマイズするオプションが用意されており、推奨されています。
アクション: エージェントがお客様をサポートするために行うこととして定義されます。簡潔な要約をカスタマイズするオプションが用意されており、推奨されています。
解像度: 4 つのオプションがあります。
- Y: はい。お客様の問題と質問がすべて解決している。
- P: 部分的。複数のお客様の問題や問い合わせの一部のみが解決された。
- N: いいえ。お客様の問題や質問は解決していません。
- N/A: お客様から会話の中で具体的な問題や質問が提起されていない。
顧客満足度: 選択肢は「不満」または「不満ではない」です。
- D: 会話の終了時にお客様が不満を感じている、または否定的な感情を抱いている。
- N: 会話の終了時にお客様が中立的または肯定的な感情を抱いている。
Reason for cancellation（キャンセルの理由）: お客様がキャンセルを希望された場合のキャンセルの理由。それ以外の場合は N/A。
エンティティ: 会話から抽出された重要なエンティティの Key-Value ペア。

要約生成ツールを作成する

コンソール

Agent Assist コンソールを使用して要約ジェネレータを作成するには、次の操作を行います。

コンソールで、[要約] ページに移動し、[ジェネレータ] を選択します。

[要約] に移動
生成ツールの名前を入力します。
生成ツールのバージョンを選択します。
出力言語を選択します。
[事前定義されたセクション] でセクションを選択します。
[カスタムセクション] にセクションを追加します。必要に応じて新しい要約タスクを定義し、必要に応じて拡張用の few-shot サンプルを追加します。
[保存] をクリックします。

REST

API を使用して要約ジェネレータを作成する手順は次のとおりです。

Generator リソースから CreateGenerator メソッドを呼び出します。
[description] フィールドにジェネレータの名前を入力します。
output_language_code フィールドに、ジェネレータの出力言語コードを入力します。
トリガーイベント MANUAL_CALL を入力します。
SummarizationContext で、事前定義されたセクションを選択し、少数ショットの例を含むカスタムセクションを追加します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際の Cloud プロジェクトの ID
LOCATION_ID: ロケーション ID

HTTP メソッドと URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/generators

リクエストの本文（JSON）:

{
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID",
  "description": "test",
  "triggerEvent": "MANUAL_CALL",
  "summarizationContext": {
    "summarizationSections": [{
      "type": "SITUATION"
    }, {
      "type": "ENTITIES"
    }, {
      "key": "custom_section",
      "definition": "Describe what the customer needs help with or has questions about. If there is an order number mentioned in the conversation, INCLUDE the order number.",
      "type": "CUSTOMER_DEFINED"
    }],
    "version": "2.1",
    "outputLanguageCode": "en-US"
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/generators"

PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/generators" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/generators/GENERATOR_ID",
  "description": "test",
  "inferenceParameter": {
    "maxOutputTokens": 1024,
    "temperature": 0.0,
    "topK": 40,
    "topP": 0.8
  },
  "triggerEvent": "MANUAL_CALL",
  "createTime": "2024-05-11T00:28:14.790937126Z",
  "updateTime": "2024-05-11T01:59:15.751724150Z",
  "summarizationContext": {
    "summarizationSections": [{
      "type": "SITUATION"
    }, {
      "type": "ENTITIES"
    }, {
      "key": "custom_section",
      "definition": "Describe what the customer needs help with or has questions about. If there is an order number mentioned in the conversation, INCLUDE the order number.",
      "type": "CUSTOMER_DEFINED"
    }],
    "version": "2.1",
    "outputLanguageCode": "en-US"
  }
}

要約生成ツールをテストする

コンソール内で、次の図に示すように、[テストジェネレータ] セクションでジェネレータをテストできます。

コンソールでジェネレータをテストするには、次の操作を行います。

コンソール

会話の文字起こし。次の図に示すように、発話を直接入力するか、JSON 形式の文字起こしをアップロードできます。
[生成] をクリックして、要約を表示します。

会話プロファイルを構成する

会話プロファイルでは、会話中にエージェントに提示される候補を制御する一連のパラメータを構成します。次の手順では、HumanAgentAssistantConfig オブジェクトを使用して ConversationProfile を作成します。

次のサンプルは、会話プロファイルを作成する方法を示しています。

コンソール

Agent Assist コンソールで、[会話プロファイル] ページに移動します。
表示名を入力します。
候補のタイプとして [会話の要約（ジェネレータ）] を選択します。
リストからジェネレータの名前を選択します。

REST

会話プロファイルリソースから create メソッドを呼び出します。
新しい会話プロファイルの名前を指定します。
言語コードを入力します。
human_agent_suggestion_config に生成ツールの名前を入力します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際の Cloud プロジェクトの ID
LOCATION_ID: ロケーション ID
CONVERSATION_PROFILE_ID: 会話プロファイル ID
GENERATOR_ID: ジェネレータ ID

HTTP メソッドと URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles

リクエストの本文（JSON）:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "displayName": "conversation-profile-with-generator",
  "humanAgentAssistantConfig": {
    "humanAgentSuggestionConfig": {
      "generators": "projects/PROJECT_ID/locations/LOCATION_ID/generators/GENERATOR_ID"
    }
  },
  "languageCode": "en-US"
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_ID/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "displayName": "conversation-profile-with-generator",
  "humanAgentAssistantConfig": {
    "humanAgentSuggestionConfig": {
      "generators": "projects/PROJECT_ID/locations/LOCATION_ID/generators/GENERATOR_ID"
    }
  },
  "languageCode": "en-US"
}

シミュレータで確認する

会話プロファイルは、Agent Assist シミュレータで確認できます。

実行時の会話

実行時に、ユーザーとエージェントのダイアログが開始されると、会話が作成されます。これは、エージェント（人間または仮想）とサポートを利用する顧客またはユーザーとの間のやり取りです。候補を表示するには、ユーザー参加者とエージェント参加者の両方を作成して、会話に追加します。

会話を作成する

会話を作成するには、Conversation リソースの create メソッドを呼び出します。

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際の Cloud プロジェクトの ID
LOCATION_ID: ロケーション ID
CONVERSATION_PROFILE_ID: 会話プロファイルの作成時に受け取った ID

HTTP メソッドと URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations

リクエストの本文（JSON）:

{
  "conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID",
  "lifecycleState": "IN_PROGRESS",
  "conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "startTime": "2018-11-05T21:05:45.622Z"
}

conversations の後のパスセグメントには、新しい会話 ID が含まれます。

ユーザー参加者を作成する

ユーザーの参加者を作成するには、Participant リソースの create メソッドを呼び出します。role フィールドに会話 ID と END_USER を指定します。

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際の Cloud プロジェクトの ID
LOCATION_ID: ロケーション ID
CONVERSATION_ID: 会話 ID

HTTP メソッドと URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants

リクエストの本文（JSON）:

{
  "role": "END_USER",
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID",
  "role": "END_USER"
}

participants の後のパスセグメントには、新しいユーザー参加者 ID が含まれます。

エージェント参加者を作成する

Participant リソースで create メソッドを呼び出します。role フィールドに会話 ID と HUMAN_AGENT または AUTOMATED_AGENT を指定します。

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際の Cloud プロジェクトの ID
LOCATION_ID: ロケーション ID
CONVERSATION_ID: 会話 ID

HTTP メソッドと URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants

リクエストの本文（JSON）:

{
  "role": "HUMAN_AGENT",
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID",
  "role": "HUMAN_AGENT"
}

participants の後のパスセグメントには、新しいエージェント参加者 ID が含まれます。

メッセージを分析する

メッセージを分析するには、次の 2 つの方法があります。

会話中。会話のエージェントメッセージを追加して分析するには、Participant リソースの analyzeContent メソッドを呼び出します。会話 ID とエージェント参加者 ID を指定します。会話にユーザーメッセージを追加して分析するには、Participant リソースの analyzeContent メソッドを呼び出します。会話 ID とユーザー参加者 ID を指定します。他の Dialogflow 機能で analyzeContent メソッドが呼び出された場合は、重複して呼び出さないでください。
会話の後。このオプションは、会話中に analyzeContent メソッドを使用しない場合に使用できます。代わりに、messages リソースの batchCreate メソッドを使用して、会話の履歴メッセージを取り込むことができます。

要約を生成

参加者のいずれかからの最新のメッセージに対する候補はいつでも取得できます。

conversations.suggestions リソースで suggestConversationSummary メソッドを呼び出します。会話 ID と、いずれかの参加者の最新のメッセージ ID を指定します。
generateStatelessSuggestion メソッドを呼び出します。ConversationContext、ジェネレータ名、トリガーイベント（MANUAL_CALL）を指定します。

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際の Cloud プロジェクトの ID
LOCATION_ID: ロケーション ID
GENERATOR_ID: ジェネレータ ID

HTTP メソッドと URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/statelessSuggestion:generate

リクエストの本文（JSON）:

{
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID",
  "generatorName": "projects/PROJECT_ID/locations/LOCATION_ID/generators/GENERATOR_ID",
  "conversationContext" {
    "messageEntries": [{
      "role": "HUMAN_AGENT",
      "text": "Hi, this is ABC messaging, how can I help you today?",
      "languageCode": "en-US"
    }, {
      "role": "END_USER",
      "text": "I want to return my order, it is broken",
      "languageCode": "en-US"
    }]
  },
  "triggerEvents": [
    "MANUAL_CALL"
  ]
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/statelessSuggestion:generate"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/statelessSuggestion:generate" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "generatorSuggestion": {
    "summarySuggestion": {
      "summarySections": [
        {
          "section": "situation",
          "summary": "customer wants to return an order."
        },
        {
          "section": "resolution",
          "summary": "N"
        }
      ]
    }
  }
}

レスポンスには概要が含まれます。

会話を完了する

会話を完了するには、conversations リソースの complete メソッドを呼び出します。会話 ID を指定します。

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: GCP プロジェクト ID
CONVERSATION_ID: 会話の作成時に受け取った ID

HTTP メソッドと URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/conversations/CONVERSATION_ID:complete

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/conversations/CONVERSATION_ID:complete"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/conversations/CONVERSATION_ID:complete" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_ID/conversations/CONVERSATION_ID",
  "lifecycleState": "COMPLETED",
  "conversationProfile": "projects/PROJECT_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "startTime": "2018-11-05T21:05:45.622Z",
  "endTime": "2018-11-06T03:50:26.930Z"
}

カスタム セクションによる要約 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

利用可能なリージョン

事前定義されたセクション

要約生成ツールを作成する

コンソール

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

要約生成ツールをテストする

コンソール

会話プロファイルを構成する

コンソール

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

シミュレータで確認する

実行時の会話

会話を作成する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

ユーザー参加者を作成する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

エージェント参加者を作成する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

メッセージを分析する

要約を生成

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

会話を完了する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

以前のバージョン

カスタムセクションによる要約