Este documento descreve como criar um agente de dados no Spanner 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 uma instância do Spanner
- Verifique se uma instância do Spanner está disponível. Para mais informações, consulte Criar uma instância.
- 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 uma conta de usuário ou serviço do IAM ao cluster. Para mais informações, consulte Aplicar papéis do IAM.
- Conceda os papéis
spanner.databaseReaderao 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. - Conceda papéis e permissões ao usuário do IAM no nível do projeto para os bancos de dados necessários.
Criar um agente de dados
Para criar um agente de dados, siga estas etapas:
No console Google Cloud , acesse a página do Spanner.
Selecione uma instância na lista e depois um banco de dados.
No menu de navegação, clique em Spanner Studio.
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 Spanner.
Selecione uma instância na lista e depois um banco de dados.
No menu de navegação, clique em Spanner Studio.
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 Spanner.
Selecione uma instância na lista e depois um banco de dados.
No menu de navegação, clique em Spanner Studio.
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.