Controlo de acesso

É comum vários membros da equipa colaborarem na criação de um agente e os serviços acederem ao agente. Através das funções, pode controlar o acesso e as autorizações concedidas aos principais.

Pode configurar o acesso através da consola de agentes conversacionais ou da consola do Google Cloud (visite a documentação, abra a consola) com a gestão de identidades e acessos (IAM). A consola do Google Cloud é usada para conceder funções da IAM a responsáveis, enquanto a consola de agentes conversacionais é usada para conceder funções de agente de agentes conversacionais (Dialogflow CX) a responsáveis. As funções de agente dos agentes conversacionais (Dialogflow CX) são funções predefinidas definidas pelos agentes conversacionais (Dialogflow CX) que restringem o acesso a um agente ou aos recursos secundários de um agente específico.

Existem algumas situações em que tem de usar a Google Cloud consola:

• A função Proprietário do projeto do IAM é concedida por predefinição ao utilizador que criou o projeto proprietário do agente. Este proprietário tem acesso total a todos os agentes no projeto. Se quiser alterar o proprietário do projeto, tem de usar a Google Cloud consola.
• Só é possível configurar o acesso ao nível do agente através da consola do Dialogflow CX. Se quiser configurar o acesso ao nível do projeto, tem de usar a Google Cloud consola.
• Um subconjunto de funções de IAM tem funções de agente de agentes conversacionais (Dialogflow CX) correspondentes. Se quiser conceder uma função ao nível do projeto ou do agente que não existe na consola do Dialogflow CX, tem de usar a consola. Google Cloud
• Se estiver a criar um agente de arquivo de dados com a interface do utilizador do Vertex AI Conversation, tem de usar a Google Cloud consola.

Se estiver a usar a API, também pode ter uma ou mais aplicações que enviam pedidos a um agente. Neste caso, pode controlar o acesso com contas de serviço.

Controle o acesso com a consola de agentes conversacionais

A consola de agentes conversacionais permite-lhe aplicar funções de agente convenientes configuradas para partilha ao nível do agente. Estas funções estão correlacionadas com funções IAM com condições IAM que limitam o acesso ao agente específico ou a um subconjunto de recursos secundários do agente.

Para aceder à configuração das funções do agente a partir da consola de agentes conversacionais, tem de lhe ser concedida a função de administrador de IAM do projeto para o projeto associado. Esta função é concedida a partir da consola Google Cloud .

As opções de partilha encontram-se nas definições do agente. Para abrir as definições de partilha de agentes:

1. Abra a consola do Dialogflow CX.
2. Escolha o seu projeto do Google Cloud.
3. Selecione o seu agente.
4. Clique em Definições do agente.
5. Clique no separador Partilhar.

Adicione um principal

1. Clique em Adicionar.
2. Introduza o endereço de email do utilizador, do grupo ou da conta de serviço.
3. Selecione Utilizador, Grupo ou Conta de serviço para o tipo de email.
4. A função Leitor do Dialogflow é adicionada por predefinição e é necessária para que os utilizadores acedam à consola de agentes conversacionais.
5. Clique em Adicionar função em Atribuir funções.
6. Selecione um tipo de função em Tipo.
7. Para as funções Editor do fluxo e Editor do ambiente, selecione fluxos ou ambientes específicos, ou mantenha a opção predefinida Tudo.
8. Opcionalmente, defina a data de validade da função.
9. Clique em Guardar.

Altere as funções principais

1. Clique no principal na lista.
2. Atualize as funções deste principal no pop-up.
3. Clique em Guardar.

Remova um diretor

1. Encontre o principal na lista.
2. Clique no botão delete eliminar para o principal.
3. Clique em OK.

Controle o acesso com a Google Cloud consola

Pode controlar o acesso com as definições da IAM. Consulte o início rápido da IAM para ver instruções detalhadas sobre como adicionar, editar e remover autorizações.

Para aceder às definições abaixo, abra a página IAM na Google Cloud consola.

Adicione um utilizador ou uma conta de serviço ao projeto

Pode conceder autorizações a utilizadores ou contas de serviço atribuindo-lhes funções no seu Google Cloud projeto. Os utilizadores são adicionados através do respetivo endereço de email. As contas de serviço também são adicionadas através do respetivo endereço de email associado. Tem de adicionar contas de serviço quando quiser usar uma conta de serviço para vários projetos. Para encontrar o endereço de email associado à sua conta de serviço, consulte a página Contas de serviço do IAM na Google Cloud consola.

Para adicionar um principal:

1. Clique no botão de adição add na parte superior da página.
2. Introduza o endereço de email do diretor.
3. Selecione uma função.
4. Clique em Guardar.

Alterar autorizações

1. Clique no botão de edição edit do diretor.
2. Selecione uma função diferente.
3. Clique em Guardar.

Remova um diretor

1. Clique no botão de eliminação delete para o principal.

Adicione uma condição para restringir o acesso a um agente

Quando adiciona ou edita um principal, pode criar uma condição do IAM que restringe o acesso a um agente.

Por exemplo:

{
    "expression": "resource.name.startsWith(\"projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID\")",
    "title": "For Conversational Agents (Dialogflow CX) Agent AGENT_ID"
}

Esta condição dá-lhe acesso básico a um agente específico. Por exemplo, uma conta de serviço com esta condição só pode chamar a API Conversational Agents (Dialogflow CX) para aceder ao agente especificado na condição para o projeto, mas não a outros agentes no projeto.

Para adicionar esta condição a uma função concedida a um principal:

1. Selecione um principal.
2. Clique no botão de edição edit do diretor.
3. Clique em Adicionar condição.
4. No campo Título, introduza For Conversational Agents (Dialogflow CX) Agent AGENT_ID e substitua AGENT_ID pelo ID do seu agente.
5. Pode adicionar qualquer descrição.
6. Selecione o editor de condições para criar a sua condição.
7. Adicione a expressão resource.name.startsWith("projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID"), substituindo AGENT_ID pelo ID do seu agente e PROJECT_ID pelo ID do seu projeto.
8. Clique em Guardar.

Funções de IAM

A tabela seguinte lista as funções IAM comuns relevantes para agentes conversacionais (Dialogflow CX). Os resumos das autorizações na tabela usam os seguintes termos:

• Acesso total: autorização para modificar o acesso, criar, eliminar, editar e ler qualquer recurso.
• Editar acesso: Autorização para criar, eliminar, editar e ler qualquer recurso.
• Acesso à sessão: autorização para chamar métodos para recursos apenas de tempo de execução durante uma conversa, como detetar a intenção, atualizar o contexto, atualizar entidades da sessão ou interações de conversa do Agent Assist.
• Acesso de leitura: Autorização para ler qualquer recurso.

OAuth

Se estiver a usar bibliotecas de cliente Google para aceder a agentes conversacionais (Dialogflow CX), não precisa de usar o OAuth diretamente, porque estas bibliotecas processam a implementação por si. No entanto, se estiver a implementar o seu próprio cliente, pode ter de implementar o seu próprio fluxo OAuth. O acesso à API Conversational Agents (Dialogflow CX) requer um dos seguintes âmbitos do OAuth:

• https://www.googleapis.com/auth/cloud-platform (acesso a todos os recursos do projeto)
• https://www.googleapis.com/auth/dialogflow (acesso a recursos de agentes de conversação [Dialogflow CX])

Pedidos que envolvem o acesso ao Cloud Storage

Alguns agentes conversacionais (Dialogflow CX) pedem acesso a objetos no Cloud Storage para ler ou escrever dados. Quando chama um destes pedidos, os agentes conversacionais (Dialogflow CX) acedem aos dados do Cloud Storage em nome do autor da chamada. Isto significa que a autenticação do seu pedido tem de ter autorizações para aceder a agentes conversacionais (Dialogflow CX), bem como aos objetos do Cloud Storage.

Quando usar uma biblioteca de cliente Google e funções do IAM, consulte o guia de controlo de acesso do Cloud Storage para obter informações sobre as funções do Cloud Storage.

Quando implementar o seu próprio cliente e usar o OAuth, tem de usar o seguinte âmbito do OAuth:

• https://www.googleapis.com/auth/cloud-platform (acesso a todos os recursos do projeto)

Funções personalizadas para acesso à ferramenta de guião

Pode fornecer um controlo de acesso detalhado para as ferramentas do manual de soluções através de autorizações e funções personalizadas.

Pode consultar as autorizações disponíveis visitando a ferramenta de pesquisa de autorizações e pesquisando dialogflow.tools.

Com essas autorizações, pode criar funções personalizadas.