Gerenciar intents com a API

Normalmente, você cria e exclui intents usando o console. No entanto, em certos 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.

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

REST

Antes de usar os dados da solicitação abaixo, 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:

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áscara 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.

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

REST

Antes de usar os dados da solicitação abaixo, 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:

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