Configuração e limpeza do Dialogflow CX

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Este guia fornece todas as etapas de configuração necessárias para começar a usar o Dialogflow CX. Ele também oferece conselhos sobre possíveis etapas de limpeza depois de testar ou testar o Dialogflow.

Antes de começar

Faça o seguinte antes de ler este guia:

  1. Leia os Princípios básicos do Dialogflow CX.
  2. Leia as Edições.

Sobre o Console do Google Cloud

O Console do Google Cloud (acesse a documentação, abra o console) é uma IU da Web usada para provisionar, configurar, gerenciar e monitorar sistemas que usam os produtos do Google Cloud. Você usa o Console do Google Cloud para configurar e gerenciar recursos do Dialogflow.

Crie um projeto

Para usar os serviços fornecidos pelo Google Cloud, crie um projeto. Um projeto organiza todos os seus recursos do Google Cloud. Ele consiste em um conjunto de colaboradores, APIs ativadas (e outros recursos), ferramentas de monitoramento, informações de faturamento e controles de autenticação e acesso. Crie um ou vários projetos e use-os para organizar os recursos do Google Cloud em uma hierarquia de recursos. Ao criar um projeto, anote o ID do projeto. Você precisará desse ID para fazer chamadas de API. Para mais informações sobre projetos, consulte a documentação do Resource Manager.

No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

Acessar o seletor de projetos

Ativar faturamento

Uma conta de faturamento é usada para definir quem paga por determinado conjunto de recursos e pode estar associada a um ou mais projetos. O uso do projeto é cobrado na conta de faturamento vinculada. Na maioria dos casos, você configura o faturamento ao criar um projeto. Para mais informações, consulte a Documentação de faturamento.

Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

Ativar a API

Ative a API do Dialogflow para o projeto. Para mais informações sobre como ativar APIs, consulte a documentação do Service Usage.

Ative a Dialogflow API.

Ative a API

Instale e inicialize a CLI do Google Cloud.

Se você planeja usar a API Dialogflow, precisará instalar e inicializar a Google Cloud CLI. A CLI gcloud é um conjunto de ferramentas usadas para gerenciar recursos e aplicativos hospedados no Google Cloud.

O link a seguir fornece as instruções:

Instale e inicialize a Google Cloud CLI.

Configurar autenticação e controle de acesso

Se você pretende usar a API do Dialogflow, precisará configurar a autenticação. Qualquer aplicativo cliente que use a API precisa ser autenticado e ter acesso aos recursos solicitados. Nesta seção, você verá importantes conceitos de autenticação e etapas para a configuração deles. Para mais informações, consulte a Visão geral da autenticação do Google Cloud.

Autenticação com contas de usuário

Contas de usuário são a melhor opção de autenticação ao aprender a API Dialogflow e para desenvolvimento local. Utilize sua conta de usuário para autenticar execuções de linha de comando REST ou chamadas de biblioteca de cliente.

Autenticação da conta de usuário na linha de comando REST

Para autenticar para chamadas de linha de comando REST, use a CLI gcloud. O comando gcloud auth login faz login na gcloud com sua conta de usuário, o que deve ser feito antes de chamar a API. O comando gcloud auth print-access-token é usado em todas as amostras de linha de comando REST nesta documentação para autenticar chamadas REST.

Para criar credenciais de usuário para seu ambiente local:

gcloud auth login

Autenticação da conta de usuário da biblioteca de cliente

Para autenticar chamadas de biblioteca de cliente, use a CLI gcloud. O comando gcloud auth application-default login faz login no gcloud para credenciais padrão do aplicativo com sua conta de usuário, o que deve ser feito antes de chamar a API. O comando gcloud auth application-default set-quota-project precisa ser usado para definir o projeto para faturamento e cotas relacionadas a chamadas de API. Normalmente, é o mesmo projeto usado pelo agente, e você fornece o ID do projeto criado nas etapas acima.

A variável de ambiente GOOGLE_APPLICATION_CREDENTIALS não pode ser definida para que as credenciais padrão do aplicativo sejam usadas pelas bibliotecas de cliente.

Para criar credenciais padrão de aplicativo para o ambiente local:

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Autenticação com contas de serviço

Contas de serviço são outra opção de autenticação que só deve ser usada em ambientes seguros, como produção ou preparo. Uma conta de serviço fornece credenciais de aplicativos e não de usuários finais. As contas de serviço são de propriedade dos projetos, e você pode criar muitas para um projeto. Veja mais informações em:

Controle de acesso com papéis

Quando um principal (conta de usuário, conta de serviço e assim por diante) chama uma API, o Google Cloud exige que o principal tenha as permissões apropriadas. Você pode conceder permissões concedendo papéis a um principal. Para saber mais, consulte a visão geral do papel.

Se você criou o projeto com essa conta, ela terá o papel básico de proprietário para o projeto. Esse papel concede acesso para chamar qualquer API do projeto. No entanto, se outra conta criou o projeto, talvez seja necessário conceder papéis à sua conta de usuário antes de chamar a API. Para ver as instruções, consulte o Guia de controle de acesso do Dialogflow.

Instalar a biblioteca de cliente do Dialogflow

Você tem três opções para chamar a API: bibliotecas de cliente compatíveis com o Google, REST e gRPC.

Bibliotecas de clientes estão disponíveis para várias linguagens conhecidas. Para ver instruções de instalação, consulte a linguagem desejada em Bibliotecas de cliente.

Limpeza

Depois de configurar e testar ou testar o Dialogflow, exclua os recursos criados:

  • Talvez você queira excluir seu agente.
  • Considere encerrar seu projeto.
  • Se você chamou gcloud auth login, isso armazenará as credenciais no diretório do usuário no seu computador. Você pode querer excluir essas credenciais chamando:
    gcloud auth revoke
  • Se você chamou gcloud auth application-default login, isso armazenará as credenciais no diretório do usuário no seu computador. Você pode querer excluir essas credenciais chamando:
    gcloud auth application-default revoke