Normalmente, cria e elimina agentes através da consola. No entanto, em determinados cenários avançados, pode ser mais fácil usar a API.
Crie um agente
Os exemplos seguintes mostram como chamar o método Create para o tipo Agent.
Selecione um protocolo e uma versão para a referência do agente:
| Protocolo | V3 | V3beta1 | 
|---|---|---|
| REST | Recurso do agente | Recurso do agente | 
| RPC | Interface do agente | Interface do agente | 
| C++ | AgentsClient | Não disponível | 
| C# | AgentsClient | Não disponível | 
| Ir | AgentsClient | Não disponível | 
| Java | AgentsClient | AgentsClient | 
| Node.js | AgentsClient | AgentsClient | 
| PHP | Não disponível | Não disponível | 
| Python | AgentsClient | AgentsClient | 
| Ruby | Não disponível | Não disponível | 
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- PROJECT_ID: o ID do seu Google Cloud projeto
 - REGION_ID: o seu ID da região
 
Método HTTP e URL:
POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents
Corpo JSON do pedido:
{
  "displayName": "My display name",
  "defaultLanguageCode": "en",
  "timeZone": "America/New_York"
}
Para enviar o seu pedido, expanda uma destas opções:
Deve receber uma resposta JSON semelhante à seguinte:
{
  "name": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID",
  "displayName": "My display name",
  "defaultLanguageCode": "en",
  "timeZone": "America/New_York",
  "startFlow": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/flows/00000000-0000-0000-0000-000000000000",
  "advancedSettings": {
    "loggingSettings": {}
  }
}
Java
Para se autenticar no Dialogflow, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Para se autenticar no Dialogflow, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Python
Para se autenticar no Dialogflow, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Elimine um agente
Os exemplos seguintes mostram como chamar o método Delete para o tipo Agent.
Selecione um protocolo e uma versão para a referência do agente:
| Protocolo | V3 | V3beta1 | 
|---|---|---|
| REST | Recurso do agente | Recurso do agente | 
| RPC | Interface do agente | Interface do agente | 
| C++ | AgentsClient | Não disponível | 
| C# | AgentsClient | Não disponível | 
| Ir | AgentsClient | Não disponível | 
| Java | AgentsClient | AgentsClient | 
| Node.js | AgentsClient | AgentsClient | 
| PHP | Não disponível | Não disponível | 
| Python | AgentsClient | AgentsClient | 
| Ruby | Não disponível | Não disponível | 
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 agente, que se encontra na resposta de criação do agente
 
Método HTTP e URL:
DELETE https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID
Para enviar o seu pedido, expanda uma destas opções:
Deve receber um código de estado de êxito (2xx) e uma resposta vazia.