Este documento descreve como criar um agente de dados no AlloyDB para PostgreSQL Studio usando um arquivo de contexto do agente. Um agente de dados está associado a um único arquivo de contexto do agente.
Para saber mais sobre agentes de dados, consulte Visão geral dos agentes de dados.Antes de começar
Conclua os pré-requisitos a seguir antes de criar um agente.
Ativar serviços obrigatórios
Ative os seguintes serviços para seu projeto:
Preparar um cluster e uma instância do AlloyDB para PostgreSQL
- Verifique se você tem acesso a um cluster e uma instância do AlloyDB ou crie um novo.
- Preencha o banco de dados com os dados e o esquema que o usuário final quer acessar.
Papéis e permissões necessárias
- Adicione um usuário ou uma conta de serviço do Identity and Access Management (IAM) ao cluster no nível do banco de dados. Para mais informações, consulte Gerenciar usuários do banco de dados.
- Conceda a função
alloydb.databaseUserao usuário do IAM no nível do projeto. Para mais informações, consulte Adicionar uma vinculação de política do IAM a um projeto.
Criar um agente de dados
Para criar um agente de dados, siga estas etapas:
No console Google Cloud , acesse a página do AlloyDB.
Selecione um cluster na lista.
No menu de navegação, clique em AlloyDB Studio.
Faça login no Studio usando a autenticação do Identity and Access Management (IAM).
No painel "Explorer", ao lado de Agentes de dados, clique em Ver ações.
Clique em Criar agente.
Em Nome do agente, insira um nome exclusivo. O nome do agente diferencia maiúsculas de minúsculas e pode conter letras, números, hifens e sublinhados.
Opcional. Em Descrição do agente, adicione uma descrição para o agente.
Opcional. Clique em Mostrar opções avançadas e, em Selecionar um local, escolha uma região para armazenar o contexto do agente.
Clique em Criar.
Criar contexto do agente
Depois de criar um agente, siga as etapas em Criar contextos usando a CLI do Gemini para criar um arquivo de contexto do agente. Depois, edite o agente para fazer upload do arquivo de contexto.
Editar um agente
Para editar um agente de dados, siga estas etapas:
No console Google Cloud , acesse a página do AlloyDB.
Selecione um cluster na lista.
No menu de navegação, clique em AlloyDB Studio.
Faça login no Studio usando a autenticação do Identity and Access Management (IAM).
No painel "Explorer", ao lado de Agentes de dados, clique em Ver ações.
Clique em Editar agente.
Opcional: edite a Descrição do agente.
Clique em Procurar na seção Fazer upload do arquivo de contexto do agente e selecione o arquivo de contexto do agente.
Clique em Salvar.
Excluir um agente de dados
Para excluir um agente de dados, siga estas etapas:
No console Google Cloud , acesse a página do AlloyDB.
Selecione um cluster na lista.
No menu de navegação, clique em AlloyDB Studio.
Faça login no Studio usando a autenticação do Identity and Access Management (IAM).
No painel "Explorer", ao lado de Agentes de dados, clique em Ver ações.
Clique em Excluir agente.
Na caixa de diálogo de confirmação Excluir agente, insira o nome do agente.
Clique em Confirmar para excluir o agente.
A seguir
- Saiba mais sobre os agentes de dados.
- Saiba como inspecionar e chamar um agente de dados.