部分產品和功能正在重新命名中。我們也正在將生成式應對手冊和流程功能遷移至單一整合式控制台。請參閱詳細說明。

本頁面由 Cloud Translation API 翻譯而成。

使用 API 管理意圖

通常，您會使用控制台建立及刪除意圖。不過，在某些進階情況下，使用 API 可能會更容易。

建立意圖

以下範例說明如何呼叫 Intent 類型的 Create 方法。

選取意圖參照項目的通訊協定和版本：

通訊協定	V3	V3beta1
REST	意圖資源	意圖資源
RPC	意圖介面	意圖介面
C++	IntentsClient	不適用
C#	IntentsClient	不適用
Go	IntentsClient	不適用
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	不適用	不適用
Python	IntentsClient	IntentsClient
Ruby	不適用	不適用

REST

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：您的 Google Cloud 專案 ID
REGION_ID：您的區域 ID
AGENT_ID：您的代理人 ID

HTTP 方法和網址：

POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents

JSON 要求主體：

{
  "displayName": "My intent display name"
}

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 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://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents"

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://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID",
  "displayName": "My intent display name",
  "priority": 500000
}

更新意圖

欄位遮罩指南會說明如何更新意圖的個別欄位。

刪除意圖

以下範例說明如何呼叫 Intent 類型的 Delete 方法。

選取意圖參照項目的通訊協定和版本：

通訊協定	V3	V3beta1
REST	意圖資源	意圖資源
RPC	意圖介面	意圖介面
C++	IntentsClient	不適用
C#	IntentsClient	不適用
Go	IntentsClient	不適用
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	不適用	不適用
Python	IntentsClient	IntentsClient
Ruby	不適用	不適用

REST

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：您的 Google Cloud 專案 ID
REGION_ID：您的區域 ID
AGENT_ID：您的代理人 ID
INTENT_ID：意圖 ID，可在建立回應中找到

HTTP 方法和網址：

DELETE https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID"

PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID" | Select-Object -Expand Content

您應該會收到執行成功的狀態碼 (2xx) 和空白回應。

使用 API 管理網頁

使用 FieldMask 更新資料

使用 API 管理意圖 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

建立意圖

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

更新意圖

刪除意圖

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

使用 API 管理意圖