Gerenciar intents com a API

Normalmente, você cria e exclui intents com o console. No entanto, em determinados cenários avançados, pode ser mais fácil usar a API.

Como criar uma intent

Os exemplos a seguir mostram como chamar o método Create para o tipo Intent. Acessar a referência da API Intent

Selecione um protocolo e uma versão para a referência de intent:

Protocolo	V3	V3beta1
REST	Recurso de intent	Recurso de intent
RPC	Interface da intent	Interface da intent
C++	IntentsClient	Indisponível
C#	IntentsClient	Indisponível
Go	IntentsClient	Indisponível
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Indisponível	Indisponível
Python	IntentsClient	IntentsClient
Ruby	Indisponível	Indisponível

Fechar

REST

Antes de usar os dados da solicitação, faça as substituições a seguir:

• PROJECT_ID: o ID do projeto do Google Cloud
• REGION_ID: o ID da sua região
• AGENT_ID: seu ID de agente

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Observação: O comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

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

Atualizar uma intent

O guia de máscaras de campo mostra como atualizar campos individuais de uma intent.

Excluir uma intent

Os exemplos a seguir mostram como chamar o método Delete para o tipo Intent. Acessar a referência da API Intent

Selecione um protocolo e uma versão para a referência de intent:

Protocolo	V3	V3beta1
REST	Recurso de intent	Recurso de intent
RPC	Interface da intent	Interface da intent
C++	IntentsClient	Indisponível
C#	IntentsClient	Indisponível
Go	IntentsClient	Indisponível
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Indisponível	Indisponível
Python	IntentsClient	IntentsClient
Ruby	Indisponível	Indisponível

Fechar

REST

Antes de usar os dados da solicitação, faça as substituições a seguir:

• PROJECT_ID: o ID do projeto do Google Cloud
• REGION_ID: o ID da sua região
• AGENT_ID: seu ID de agente
• INTENT_ID: o ID da intent, encontrado na resposta de criação.

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

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)

Observação: O comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

$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

Você receberá um código de status bem-sucedido (2xx) e uma resposta vazia.