Como usar vários projetos

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