Faça a gestão de intenções com a API

Normalmente, cria e elimina intenções através da consola. No entanto, em determinados cenários avançados, pode ser mais fácil usar a API.

Crie uma intenção

Os exemplos seguintes mostram como chamar o método Create para o tipo Intent. Aceda à referência da API Intent

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

Protocolo	V3	V3beta1
REST	Recurso de intenção	Recurso de intenção
RPC	Interface de intenção	Interface de intenção
C++	IntentsClient	Não disponível
C#	IntentsClient	Não disponível
Ir	IntentsClient	Não disponível
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Não disponível	Não disponível
Python	IntentsClient	IntentsClient
Ruby	Não disponível	Não disponível

Close

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do seu projeto do Google Cloud
• REGION_ID: o seu ID da região
• AGENT_ID: o ID do seu 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 do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

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

Atualize uma intenção

O guia de máscara de campo mostra como atualizar campos individuais de uma intenção.

Elimine uma intenção

Os exemplos seguintes mostram como chamar o método Delete para o tipo Intent. Aceda à referência da API Intent

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

Protocolo	V3	V3beta1
REST	Recurso de intenção	Recurso de intenção
RPC	Interface de intenção	Interface de intenção
C++	IntentsClient	Não disponível
C#	IntentsClient	Não disponível
Ir	IntentsClient	Não disponível
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Não disponível	Não disponível
Python	IntentsClient	IntentsClient
Ruby	Não disponível	Não disponível

Close

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do seu projeto do Google Cloud
• REGION_ID: o seu ID da região
• AGENT_ID: o ID do seu agente
• INTENT_ID: o ID da intenção, 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

Deve receber um código de estado de êxito (2xx) e uma resposta vazia.