Em alguns casos, pode ser necessário criar vários projetos do Google Cloud para usar o Dialogflow:
- Pode ser útil criar um projeto para autenticação, cotas e faturamento, além de outros projetos para dados do agente.
- Cada projeto pode ter no máximo um agente por região. Se você precisar de vários agentes na mesma região, serão necessários vários projetos.
Projetos de consumidores e recursos
Ao fazer chamadas para a API, você normalmente fornece chaves de conta de serviço para autenticação. Cada conta de serviço pertence a um projeto específico, mas elas podem ter papéis fornecidos para acessar recursos de outros projetos. O projeto associado à conta de serviço fornecida para uma chamada de API é intitulado de projeto do consumidor.
Ao fazer chamadas para a API, sua solicitação especifica o projeto do agente. Esse projeto é conhecido como o projeto do recurso.
Por exemplo,
na solicitação curl REST a seguir,
o projeto associado a AGENT_ID
é o projeto de recurso,
e o projeto associado à conta de serviço usada para gerar TOKEN
é o projeto do consumidor:
curl -X GET -H "Authorization: Bearer TOKEN" "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/AGENT_ID"
Um projeto pode desempenhar o papel de consumidor e de recurso. Os dados, as cobranças e as cotas do agente estão associados apenas a este projeto.
Quando os projetos de consumidor e de recursos são projetos diferentes, cobranças, restrições de cota, informações do agente e um requisito para ativar a API são aplicáveis a um ou aos dois projetos. A tabela a seguir mostra a associação de uma chamada de API com dois projetos:
Descrição | Projeto do consumidor (projeto da conta de serviço) | Projeto de recurso (projeto do agente) | Observações |
---|---|---|---|
Projeto que gera cobranças | ✔ | ||
Projeto vinculado a quotas | ✔ | ||
Projeto que contém o agente que determina a edição de teste ou Essentials do Dialogflow | ✔ | Se o projeto do consumidor não tiver um agente, crie um agente vazio e faça upgrade para a edição Essentials. | |
Projeto que contém todos os dados do agente e a edição Dialogflow ou Teste ou Essentials | ✔ | ||
Projetos em que você precisa ativar a API Dialogflow | ✔ | ✔ | A API Dialogflow precisa estar ativada para os dois tipos de projeto. |
Projeto que mostra o uso da API no painel de APIs do console do Cloud | ✔ |