Este documento descreve como criar um agente de dados no Spanner Studio através de um ficheiro de contexto do agente. Um agente de dados está associado a um único ficheiro de contexto do agente.
Para saber mais sobre os agentes de dados, consulte o artigo Vista geral dos agentes de dados.Antes de começar
Cumpra os seguintes pré-requisitos antes de criar um agente.
Ative os serviços necessários
Ative os seguintes serviços para o seu projeto:
Prepare uma instância do Spanner
- Certifique-se de que existe uma instância do Spanner disponível. Para mais informações, consulte Crie uma instância.
- Preencha a base de dados com os dados e o esquema aos quais o utilizador final quer aceder.
Funções e autorizações necessárias
- Adicione um utilizador do IAM ou uma conta de serviço ao cluster. Para mais informações, consulte o artigo Aplique funções do IAM.
- Conceda as funções
spanner.databaseReaderao utilizador do IAM ao nível do projeto. Para mais informações, consulte o artigo Adicione uma associação de políticas de IAM a um projeto. - Conceda funções e autorizações ao utilizador do IAM ao nível do projeto para as bases de dados necessárias.
Crie um agente de dados
Para criar um agente de dados, siga estes passos:
Na Google Cloud consola, aceda à página do Spanner.
Selecione uma instância na lista e, de seguida, selecione uma base de dados.
No menu de navegação, clique em Spanner Studio.
No painel do explorador, junto a Agentes de dados, clique em Ver ações.
Clique em Criar agente.
Em Nome do agente, indique um nome exclusivo para o agente. O nome do agente é sensível a maiúsculas e minúsculas e pode conter letras, números, hífenes e sublinhados.
Opcional. Em Descrição do agente, adicione uma descrição para o seu agente.
Opcional. Clique em Mostrar opções avançadas e, em Selecionar uma localização, selecione uma região para armazenar o contexto do agente.
Clique em Criar.
Crie o contexto do agente
Depois de criar um agente, siga os passos em Crie contextos com a CLI do Gemini para criar um ficheiro de contexto do agente. Em seguida, pode editar o seu agente para carregar o ficheiro de contexto.
Edite um agente
Para editar um agente de dados, siga estes passos:
Na Google Cloud consola, aceda à página do Spanner.
Selecione uma instância na lista e, de seguida, selecione uma base de dados.
No menu de navegação, clique em Spanner Studio.
No painel do explorador, junto a Agentes de dados, clique em Ver ações.
Clique em Editar agente.
Opcional: edite a descrição do agente.
Clique em Procurar na secção Carregar ficheiro de contexto do agente e selecione o ficheiro de contexto do agente.
Clique em Guardar.
Elimine um agente de dados
Para eliminar um agente de dados, siga estes passos:
Na Google Cloud consola, aceda à página do Spanner.
Selecione uma instância na lista e, de seguida, selecione uma base de dados.
No menu de navegação, clique em Spanner Studio.
No painel do explorador, junto a Agentes de dados, clique em Ver ações.
Clique em Eliminar agente.
Na caixa de diálogo de confirmação Eliminar agente, introduza o nome do agente.
Clique em Confirmar para eliminar o agente.
O que se segue?
- Saiba mais acerca dos agentes de dados.
- Saiba como inspecionar e chamar um agente de dados.