Alguns produtos e recursos estão sendo renomeados. Os recursos de playbook generativo e de fluxo também estão sendo migrados para um único console consolidado. Confira os detalhes.

Esta página foi traduzida pela API Cloud Translation.

Configuração e limpeza

Este guia fornece todas as etapas de configuração necessárias para começar a usar os agentes de conversação (Dialogflow CX). Ele também fornece recomendações para possíveis etapas de limpeza depois de testar ou testar agentes de conversação (Dialogflow CX).

Sobre o Google Cloud console

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

Criar um projeto

Para usar os serviços fornecidos por Google Cloud, crie um projeto. Um projeto organiza todos os recursos 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 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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

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.

Make sure that billing is enabled for your Google Cloud project.

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.

Enable the Dialogflow API.

Enable the API

Se você for usar manipuladores de repositório de dados, também será necessário ativar o serviço do Vertex AI Agent Builder.

Instale e inicialize a CLI do Google Cloud.

Se você planeja usar a API Dialogflow, é necessário instalar e inicializar a CLI do Google Cloud. 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:

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

Configurar a autenticação e o 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çãoGoogle Cloud .

Autenticação com contas de usuário

As contas de usuário são a melhor opção de autenticação para aprender sobre a API Dialogflow e desenvolver para locais. Use sua conta de usuário para fazer a autenticação para execuções de linha de comando REST ou chamadas de biblioteca de cliente.

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

Observação: se você estiver usando o Cloud Shell, o login no gcloud será feito automaticamente, então não precisa executar gcloud auth login.

Para fazer a autenticação em chamadas de linha de comando REST, use a CLI gcloud. O comando gcloud auth login faz login no 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 as 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.

Não defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para que as credenciais padrão do aplicativo sejam usadas pelas bibliotecas de cliente.

Para criar o Application Default Credentials para seu ambiente local:

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

Autenticação com contas de serviço

As contas de serviço fornecem credenciais para aplicativos, e não para 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, Google Cloud exige que o principal tenha as permissões adequadas. Você pode conceder permissões concedendo papéis a um principal. Para mais informações, 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 fornece 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 instruções, consulte o Guia de controle de acesso do Dialogflow.

Instalar a biblioteca de cliente dos agentes de conversação (Dialogflow CX)

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 instruções de instalação, consulte a linguagem desejada em Bibliotecas de cliente.

Limpeza

Depois de configurar e testar o Dialogflow, é possível excluir os recursos criados:

Talvez seja necessário excluir o agente.
É possível encerrar seu projeto.
Se você chamou gcloud auth login, isso armazena 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 armazena as credenciais no diretório do usuário no seu computador. Você pode querer excluir essas credenciais chamando:
```
gcloud auth application-default revoke
```

Generativa x determinística

Criar um agente usando playbooks