部分產品和功能正在重新命名。生成式代理應對手冊和流程功能也會遷移至單一整合式控制台。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

實作 Webhook

本指南提供多種實作 Webhook 的範例，以及 Webhook 疑難排解建議。

設定工作階段參數

下列範例說明如何設定工作階段參數。

Go

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

請參閱 Webhook 快速入門導覽課程。

Java

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。


// TODO: Change class name to Example
// TODO: Uncomment the line below before running cloud function
// package com.example;

import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonObject;
import java.io.BufferedWriter;

public class WebhookConfigureSessionParameters implements HttpFunction {
  @Override
  public void service(HttpRequest request, HttpResponse response) throws Exception {
    JsonObject orderParameter = new JsonObject();
    orderParameter.addProperty("order_number", "12345");

    JsonObject parameterObject = new JsonObject();
    parameterObject.add("parameters", orderParameter);

    // Creates webhook response object
    JsonObject webhookResponse = new JsonObject();
    webhookResponse.add("session_info", parameterObject);

    Gson gson = new GsonBuilder().setPrettyPrinting().create();
    String jsonResponseObject = gson.toJson(webhookResponse);

    /** { "session_info": { "parameters": { "order_number": "12345" } } } */
    BufferedWriter writer = response.getWriter();
    // Sends the webhookResponseObject
    writer.write(jsonResponseObject.toString());
  }
}

Node.js

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

const functions = require('@google-cloud/functions-framework');

functions.http('configureSessionParams', (request, response) => {
  // Session parameter configured by the webhook
  const orderNumber = 123;

  const jsonResponse = {
    sessionInfo: {
      parameters: {
        orderNumber: orderNumber,
      },
    },
  };

  response.send(jsonResponse);
});

Python

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

import functions_framework

# TODO (developer): change entry point to configure_session_params in Cloud Function


@functions_framework.http
def configure_session_params(request):
    """Webhook to validate or configure new session parameters."""

    order_number = 123

    json_response = {
        "sessionInfo": {
            "parameters": {
                "orderNumber": order_number,
            },
        },
    }

    return json_response

傳回執行要求回覆

以下範例說明如何傳回執行要求回應。

Go

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

請參閱 Webhook 快速入門導覽課程。

Java

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。


// TODO: Change class name to Example
// TODO: add GSON dependency to Pom file
// (https://mvnrepository.com/artifact/com.google.code.gson/gson/2.8.5)
// TODO: Uncomment the line bellow before running cloud function
// package com.example;

import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import java.io.BufferedWriter;

public class BasicWebhook implements HttpFunction {
  @Override
  public void service(HttpRequest request, HttpResponse response) throws Exception {
    Gson gson = new GsonBuilder().create();
    JsonObject parsedRequest = gson.fromJson(request.getReader(), JsonObject.class);

    // For more information on the structure of this object https://cloud.google.com/dialogflow/cx/docs/reference/rest/v3/Fulfillment
    String requestTag = parsedRequest.getAsJsonObject("fulfillmentInfo")
        .getAsJsonPrimitive("tag").toString();
    JsonObject responseObject = null;
    String defaultIntent = "\"Default Welcome Intent\"";
    String secondIntent = "\"get-agent-name\"";
    String responseText = "";

    // Compares the Intent Tag to provide the correct response 
    if (requestTag.equals(defaultIntent)) {
      responseText = "\"Hello from a Java GCF Webhook\"";
    } else if (requestTag.equals(secondIntent)) {
      responseText = "\"My name is Flowhook\"";
    } else {
      responseText = "\"Sorry I didn't get that\"";
    }

    // Constructing the response jsonObject 
    responseObject =
        JsonParser
            .parseString(
                "{ \"fulfillment_response\": { \"messages\": [ { \"text\": { \"text\": ["
                    + responseText
                    + "] } } ] } }")
            .getAsJsonObject();
    BufferedWriter writer = response.getWriter();

    //Sends the responseObject
    writer.write(responseObject.toString());
  }
}

Node.js

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

const functions = require('@google-cloud/functions-framework');

functions.http('handleWebhook', (request, response) => {
  const tag = request.body.fulfillmentInfo.tag;
  let text = '';

  if (tag === 'Default Welcome Intent') {
    text = 'Hello from a GCF Webhook';
  } else if (tag === 'get-name') {
    text = 'My name is Flowhook';
  } else {
    text = `There are no fulfillment responses defined for "${tag}"" tag`;
  }

  const jsonResponse = {
    fulfillment_response: {
      messages: [
        {
          text: {
            //fulfillment text response to be sent to the agent
            text: [text],
          },
        },
      ],
    },
  };

  response.send(jsonResponse);
});

Python

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

import functions_framework

# TODO(developer): change entry point to handle_webhook in cloud function


@functions_framework.http
def handle_webhook(request):
    req = request.get_json()

    tag = req["fulfillmentInfo"]["tag"]

    if tag == "Default Welcome Intent":
        text = "Hello from a GCF Webhook"
    elif tag == "get-name":
        text = "My name is Flowhook"
    else:
        text = f"There are no fulfillment responses defined for {tag} tag"

    # You can also use the google.cloud.dialogflowcx_v3.types.WebhookRequest protos instead of manually writing the json object
    # Please see https://googleapis.dev/python/dialogflow/latest/dialogflow_v2/types.html?highlight=webhookresponse#google.cloud.dialogflow_v2.types.WebhookResponse for an overview
    res = {"fulfillment_response": {"messages": [{"text": {"text": [text]}}]}}

    # Returns json
    return res

視需要設定表單參數

下列範例說明如何將參數標示為必要。

Java

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。


// TODO: Change class name to Example
// TODO: Uncomment the line below before running cloud function
// package com.example;

import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
import java.io.BufferedWriter;

public class ConfigureWebhookToSetFormParametersAsOptionalOrRequired implements HttpFunction {
  @Override
  public void service(HttpRequest request, HttpResponse response) throws Exception {
    JsonObject parameterObject = new JsonObject();
    parameterObject.addProperty("display_name", "order_number");
    parameterObject.addProperty("required", "true");
    parameterObject.addProperty("state", "VALID");

    JsonArray parameterInfoList = new JsonArray();
    parameterInfoList.add(parameterObject);

    JsonObject parameterInfoObject = new JsonObject();
    parameterInfoObject.add("parameter_info", parameterInfoList);

    JsonObject formInfo = new JsonObject();
    formInfo.add("form_info", parameterInfoObject);

    // Constructs the webhook response object
    JsonObject webhookResponse = new JsonObject();
    webhookResponse.add("page_info", formInfo);

    Gson gson = new GsonBuilder().setPrettyPrinting().create();
    String jsonResponseObject = gson.toJson(webhookResponse);

    /* {
     *   "page_info": {
     *     "form_info": {
     *       "parameter_info": [
     *         {
     *           "display_name": "order_number",
     *           "required": "true",
     *           "state": "VALID"
     *         }
     *       ]
     *     }
     *   }
     * }
     */

    BufferedWriter writer = response.getWriter();

    // Sends the responseObject
    writer.write(jsonResponseObject.toString());
  }
}

Node.js

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

const functions = require('@google-cloud/functions-framework');

functions.http('configureOptionalFormParam', (request, response) => {
  // The value of the parameter that the webhook will set as optional or required.
  // Note that the webhook cannot add or remove any form parameter

  const jsonResponse = {
    pageInfo: {
      formInfo: {
        parameterInfo: [
          {
            displayName: 'order-number',
            // if required: false, the agent will not reprompt for this parameter, even if the state is 'INVALID'
            required: true,
            state: 'VALID',
          },
        ],
      },
    },
  };

  // Info about form parameter that is sent in the webhook response:
  console.log(
    'Parameter Info: \n',
    jsonResponse.pageInfo.formInfo.parameterInfo[0]
  );

  response.send(jsonResponse);
});

驗證表單參數

以下範例說明如何驗證表單參數。

Java

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。


// TODO: Change class name to Example
// TODO: Uncomment the line below before running cloud function
// package com.example;

import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
import java.io.BufferedWriter;

public class WebhookValidateFormParameter implements HttpFunction {
  @Override
  public void service(HttpRequest request, HttpResponse response) throws Exception {
    JsonObject sessionInfo = new JsonObject();
    JsonObject sessionParameter = new JsonObject();

    sessionParameter.addProperty("order_number", "null");
    sessionInfo.add("parameters", sessionParameter);

    JsonObject parameterObject = new JsonObject();
    parameterObject.addProperty("display_name", "order_number");
    parameterObject.addProperty("required", "true");
    parameterObject.addProperty("state", "INVALID");
    parameterObject.addProperty("value", "123");

    JsonArray parameterInfoList = new JsonArray();
    parameterInfoList.add(parameterObject);

    JsonObject parameterInfoObject = new JsonObject();
    parameterInfoObject.add("parameter_info", parameterInfoList);

    JsonObject pageInfo = new JsonObject();
    pageInfo.add("form_info", parameterInfoObject);

    // Constructs the webhook response object
    JsonObject webhookResponse = new JsonObject();
    webhookResponse.add("page_info", pageInfo);
    webhookResponse.add("session_info", sessionInfo);

    Gson gson = new GsonBuilder().setPrettyPrinting().create();
    String jsonResponseObject = gson.toJson(webhookResponse);

    /**
     * { "page_info": { "form_info": { "parameter_info": [ { "display_name": "order_number",
     * "required": "true", "state": "INVALID", "value": "123" } ] } }, "session_info": {
     * "parameters": { "order_number": "null" } } }
     */
    BufferedWriter writer = response.getWriter();

    // Sends the responseObject
    writer.write(jsonResponseObject.toString());
  }
}

Node.js

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

const functions = require('@google-cloud/functions-framework');

functions.http('validateParameter', (request, response) => {
  // Webhook will validate or invalidate parameter based on logic configured by the user.
  // Access parameter values through the webhook request via `request.body.pageInfo.formInfo.parameterInfo[]`
  const jsonResponse = {
    page_info: {
      form_info: {
        parameter_info: [
          {
            displayName: 'orderNumber',
            required: true,
            state: 'INVALID',
            value: 123,
          },
        ],
      },
    },
    sessionInfo: {
      parameters: {
        // Set session parameter to null if the form parameter is 'INVALID' and your agent needs to reprompt the user
        orderNumber: null,
      },
    },
  };

  response.send(jsonResponse);
});

Python

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

import functions_framework


@functions_framework.http
def validate_parameter(request):
    """Webhook will validate or invalidate parameter based on logic configured by the user."""
    return {
        "page_info": {
            "form_info": {
                "parameter_info": [
                    {
                        "displayName": "orderNumber",
                        "required": True,
                        "state": "INVALID",
                        "value": 123,
                    },
                ],
            },
        },
        "sessionInfo": {
            "parameters": {
                # Set session parameter to None if the form parameter is 'INVALID' and your agent needs to reprompt the user
                "orderNumber": None,
            },
        },
    }

記錄工作階段 ID

以下範例說明如何記錄 Webhook 要求的 session ID。

Python

如要向 Dialogflow CX 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。


import re

import functions_framework


@functions_framework.http
def log_session_id_for_troubleshooting(request):
    """Webhook will log session id corresponding to request."""

    req = request.get_json()
    # You can read more about SessionInfo at https://cloud.google.com/dialogflow/cx/docs/reference/rest/v3/SessionInfo
    # Use a regex pattern to get the session ID
    session_id_regex = r".+\/sessions\/(.+)"
    session = req["sessionInfo"]["session"]
    regex_match = re.search(session_id_regex, session)
    session_id = regex_match.group(1)

    # Instead of printing, use the logging tools available to you
    print(f"Debug Node: session ID = {session_id}")

    # Return a generic response
    res = {
        "fulfillment_response": {
            "messages": [{"text": {"text": [f"Request Session ID: {session_id}"]}}]
        }
    }

    # Returns json
    return res

疑難排解

Webhook 呼叫的生命週期

Webhook 呼叫一律由 Dialogflow CX 發起，並透過 HTTPS 傳送至網路伺服器。一般網路服務 Webhook 呼叫源自 Google 擁有的網際網路 IP 位址，可連至公開網際網路中的網路伺服器 (Webhook 伺服器)。另一方面，Service Directory Webhook 一律從內部Google Cloud 位址啟動，且只能連線至 Google Cloud內私人網路中的 Webhook 伺服器。

用於偵錯 Webhook 的實用記錄

偵錯 Webhook 問題時，通常需要收集 Cloud Logging Dialogflow CX 記錄和 Webhook 伺服器記錄。如果 Webhook 伺服器是使用 Cloud Run functions 實作，其記錄會位於 Cloud Logging。否則，記錄通常會存放在 Webhook 伺服器執行的地方。

標準 Webhook 記錄包含 detectIntentResponseId 欄位，其中含有 UUID，可用於追蹤 Webhook 伺服器中的特定呼叫。啟用 Cloud Logging 後，這項記錄會存在於 Dialogflow CX Cloud Logging 記錄中。

常見的 Webhook 問題

在 Dialogflow CX 記錄中，Webhook 呼叫可能出現的錯誤包括：

Webhook 伺服器主機名稱解析錯誤

Dialogflow CX 查詢一般 Webhook 的主機名稱，但 DNS 中沒有該主機名稱。請確認主機名稱已在公開 DNS 中註冊。如果主機名稱是新的，記錄可能需要一些時間才會生效。Cloud Logging 記錄訊息：State: URL_ERROR, Reason: ERROR_DNS。

Webhook 伺服器傳回用戶端錯誤

除了 ERROR_DNS 之外，這個狀態表示 Webhook 伺服器傳回 4xx 回應。這可能是未經授權的狀態 (401 - ERROR_AUTHENTICATION)，或是在 Webhook 伺服器中找不到網址 (404 - ERROR_NOT_FOUND)。 Cloud Logging 記錄訊息：State: URL_ERROR。

Dialogflow 代理在 Webhook 伺服器傳回回應前逾時

在網路伺服器完成前，Dialogflow CX 已達到 Webhook 逾時限制。這裡有兩種可能的方法：縮短 Webhook 伺服器處理時間，或增加 Dialogflow CX 等待 Webhook 的時間。縮短處理時間通常能帶來最佳結果，但在許多情況下，這並非易事。請注意，Webhook 有最長逾時限制，且使用者需要等待更久，才能從代理取得答案，然後才能提高這項設定。Cloud Logging 訊息：State: URL_TIMEOUT, Reason: TIMEOUT_WEB。

Webhook 伺服器傳回回應前，gRPC 逾時

在 Webhook 呼叫完成前，Dialogflow CX API 呼叫中的 gRPC 已達到設定的時間限制。這項限制通常是在整合層級設定，與 Dialogflow CX 參數和 Webhook 逾時限制無關。如要進一步瞭解 gRPC 期限，請參閱 https://grpc.io/docs/guides/deadlines/。Cloud Logging 訊息：State: URL_REJECTED, Reason: REJECTED_DEADLINE_EXCEEDED。

Dialogflow 無法連上 Webhook 伺服器

發生網路錯誤，因此無法連上 Webhook 伺服器，或是連線已建立，但 Webhook 伺服器傳回 HTTP 狀態 5xx，表示處理要求時發生問題。確認 Dialogflow CX 可以在網路層級連上 Webhook 伺服器位址。如果要求顯示在 Webhook 伺服器記錄中，請找出呼叫傳回 5xx 錯誤的原因。Cloud Logging 訊息：State: URL_UNREACHABLE。

追蹤 Webhook 呼叫

您可以使用工作階段 ID、detectIntentResponse ID、Cloud Run 函式的追蹤記錄 ID 和呼叫時間戳記，在 Dialogflow CX 和 Webhook 伺服器之間建立標準 Webhook 呼叫的關聯。您可以在設計階段，使用呼叫的時間戳記和 Webhook 定義中指定的會話參數值，靈活追蹤 Webhook。如要進一步瞭解標準和彈性 Webhook 要求，請參閱「Webhook」。

工作階段 ID 會顯示在 WebhookRequest 的 sessionInfo.session 欄位中。每個對話的工作階段 ID 都不應重複，這有助於比較代理記錄和 Webhook 記錄，找出使用相同工作階段 ID 的要求。上一節「記錄工作階段 ID」說明如何從 Webhook 記錄工作階段 ID。

此外，如果您在 Cloud Run functions 或類似的 Google Cloud 無伺服器選項上託管 Webhook，可以使用記錄項目中的 trace 欄位做為記錄篩選器。單次執行函式會產生多個具有相同追蹤值的記錄項目。

下一個範例同時使用工作階段 ID 和追蹤記錄值，將特定 Dialogflow CX 代理錯誤記錄與對應的 Cloud Run functions Webhook 記錄項目建立關聯。這個範例會針對已啟用 Cloud Logging 的代理，使用 Cloud Logging 篩選器。

1. 篩選 Dialogflow CX 記錄，找出特定代理的錯誤記錄

使用下列 Cloud Logging 篩選器，篩選出特定代理的 Dialogflow CX 錯誤記錄：

labels.location_id="global"
labels.agent_id="AGENT_ID"
severity=ERROR

Webhook 記錄錯誤項目如下所示：

{
  "insertId": "-j4gkkre31e2o",
  "jsonPayload": {
    "code": 14,
    "message": "Error calling webhook 'https://us-central1-PROJECT_ID.cloudfunctions.net/function-webhook': State: URL_UNREACHABLE, Reason: UNREACHABLE_5xx, HTTP status code: 500"
  },
  "labels": {
    "agent_id": "e9e01392-1351-42dc-9b15-b583fb2d2881",
    "environment_id": "",
    "location_id": "global",
    "session_id": "07c899-a86-78b-a77-569625b37"
  },
  "logName": "projects/PROJECT_ID/logs/dialogflow-runtime.googleapis.com%2Frequests",
  "receiveTimestamp": "2024-10-28T21:49:04.288439054Z",
  "resource": {
    "labels": {
      "project_id": "PROJECT_ID"
    },
    "type": "global",
  },
  "severity": "ERROR",
  "timestamp": "2024-10-28T21:49:04.132548Z"
}

請注意，labels.session_id 欄位包含工作階段 ID。您會在下一個步驟中使用工作階段 ID。

2. 依工作階段 ID 篩選 Cloud Run functions 記錄

使用下列 Cloud Logging 篩選器，依工作階段 ID 篩選 Cloud Run functions 記錄：

resource.type = "cloud_run_revision"
resource.labels.service_name = "CLOUD_RUN_FUNCTION_NAME"
resource.labels.location = "CLOUD_RUN_FUNCTION_REGION"
textPayload="Debug Node: session ID = SESSION_ID"

產生的記錄會對應至在指定工作階段中建立的 Webhook 記錄。例如：

{
  "insertId": "671c42940007ebebdbb1d56e",
  "labels": {
    "execution_id": "pgy8jvvblovs",
    "goog-managed-by": "cloudfunctions",
    "instance_id": "004940b3b8e3d975a4b11a4ed7d1ded4ce3ed37467ffc5e2a8f13a1908db928f8200b01cc554a5eda66ffc9d23d76dd75cec1619a07cb5751fa2e8a93bc6cfc3df86dfa0650a"
  },
  "logName": "projects/PROJECT_ID/logs/run.googleapis.com%2Fstdout",
  "receiveTimestamp": "2024-10-26T01:15:00.523313187Z",
  "resource": {
    "labels": {
      "configuration_name": "function-webhook",
      "location": "us-central1",
      "project_id": "PROJECT_ID",
      "revision_name": "function-webhook-00001-jiv",
      "service_name": "function-webhook",
    },
    "type": "cloud_run_revision"
  },
  "spanId": "6938366936362981595",
  "trace": "d1b54fbc8945dd59bdcaed37d7d5e185",
  "textPayload": "Debug Node: session ID = 07c899-a86-78b-a77-569625b37",
  "timestamp": "2024-10-26T01:15:00.519147Z"
}

請記下 trace 欄位，下一步會用到。

3. 篩選特定追蹤記錄的 Cloud 函式記錄

使用下列 Cloud Logging 篩選器，篩選特定追蹤記錄的 Cloud 函式記錄：

resource.type = "cloud_run_revision"
resource.labels.service_name = "CLOUD_RUN_FUNCTION_NAME"
resource.labels.location = "CLOUD_RUN_FUNCTION_REGION"
trace="projects/PROJECT_ID/traces/TRACE_ID"

其中 TRACE_ID 是追蹤記錄的最後一個區段。例如，projects/PROJECT_ID/traces/e41eefc1fac48665b442bfa400cc2f5e 的 TRACE_ID 為 e41eefc1fac48665b442bfa400cc2f5e。

結果會是 Webhook 伺服器記錄，在執行與步驟 1 工作階段 ID 和步驟 2 追蹤記錄相關聯的 Webhook 要求時產生。記錄應如下所示。

{
  "insertId": "671c42940008465e29f5faf0",
  "httpRequest": {
    "requestMethod": "POST",
    "requestUrl": "https://us-central1-TEST_PROJECT.cloudfunctions.net/function-webhook",
    "requestSize": "2410",
    "status": 200,
    "responseSize": "263",
    "userAgent": "Google-Dialogflow",
    "remoteIp": "8.34.210.1",
    "serverIp": "216.239.36.1",
    "latency": "0.166482342s",
    "protocol": "HTTP/1.1"
  },
  "resource": {
    "type": "cloud_run_revision",
    "labels": {
      "project_id": "PROJECT_ID",
      "service_name": "function-webhook",
      "location": "us-central1",
      "revision_name": "function-webhook-00001-jiv",
      "configuration_name": "function-webhook"
    }
  },
  "timestamp": "2024-10-26T01:15:00.352197Z",
  "severity": "INFO",
  "labels": {
    "instanceId": "004940b3b813af8a656c92aac1bd07ffad5165f1353e1e346b6161c14bcde225f68f4a88ceedc08aa9020f387b1b59471f73de45f2882a710ced37dea921f05ad962347690be",
    "goog-managed-by": "cloudfunctions"
  },
  "logName": "projects/test-project-12837/logs/run.googleapis.com%2Frequests",
  "trace": "projects/test-project-12837/traces/d1b54fbc8945dd59bdcaed37d7d5e185",
  "receiveTimestamp": "2024-10-26T01:15:00.548931586Z",
  "spanId": "604a07f7b33b18db",
  "traceSampled": true
}

偵測意圖

使用 API 管理服務專員

實作 Webhook 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

設定工作階段參數

Go

Java

Node.js

Python

傳回執行要求回覆

Go

Java

Node.js

Python

視需要設定表單參數

Java

Node.js

驗證表單參數

Java

Node.js

Python

記錄工作階段 ID

Python

疑難排解

Webhook 呼叫的生命週期

用於偵錯 Webhook 的實用記錄

常見的 Webhook 問題

Webhook 伺服器主機名稱解析錯誤

Webhook 伺服器傳回用戶端錯誤

Dialogflow 代理在 Webhook 伺服器傳回回應前逾時

Webhook 伺服器傳回回應前，gRPC 逾時

Dialogflow 無法連上 Webhook 伺服器

追蹤 Webhook 呼叫

1. 篩選 Dialogflow CX 記錄，找出特定代理的錯誤記錄

2. 依工作階段 ID 篩選 Cloud Run functions 記錄

3. 篩選特定追蹤記錄的 Cloud 函式記錄

實作 Webhook