Gerenciar agentes de dados no Cloud SQL para PostgreSQL Studio

Neste documento, descrevemos como criar um agente de dados no Cloud SQL 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 uma instância do Cloud SQL

  • Verifique se você tem acesso a uma instância do Cloud SQL ou crie uma. Para mais informações, consulte Criar instâncias para o Cloud SQL.
  • 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

Conceder permissão executesql à instância do Cloud SQL

Para conceder a permissão executesql à instância do Cloud SQL e ativar a API Data do Cloud SQL, execute o seguinte comando: 
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
Substitua INSTANCE_ID pelo ID da instância do Cloud SQL.

Criar um agente de dados

Para criar um agente de dados, siga estas etapas:

  1. No console Google Cloud , acesse a página do Cloud SQL.

    Acessar o Cloud SQL

  2. Selecione uma instância na lista.

  3. No menu de navegação, clique em Cloud SQL Studio.

  4. Faça login no Studio usando a autenticação do Identity and Access Management (IAM).

  5. No painel "Explorer", ao lado de Agentes de dados, clique em Ver ações.

  6. Clique em Criar agente.

  7. 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.

  8. Opcional. Em Descrição do agente, adicione uma descrição para o agente.

  9. Opcional. Clique em Mostrar opções avançadas e, em Selecionar um local, escolha uma região para armazenar o contexto do agente. Você pode selecionar uma das seguintes regiões compatíveis:

    • us-central1
    • us-east1
    • europe-west4
    • asia-southeast1

  10. 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:

  1. No console Google Cloud , acesse a página do Cloud SQL.

    Acessar o Cloud SQL

  2. Selecione uma instância na lista.

  3. No menu de navegação, clique em Cloud SQL Studio.

  4. Faça login no Studio usando a autenticação do Identity and Access Management (IAM).

  5. No painel "Explorer", ao lado de Agentes de dados, clique em Ver ações.

  6. Clique em Editar agente.

  7. Opcional: edite a Descrição do agente.

  8. Clique em Procurar na seção Fazer upload do arquivo de contexto do agente e selecione o arquivo de contexto do agente.

  9. Clique em Salvar.

Excluir um agente de dados

Para excluir um agente de dados, siga estas etapas:

  1. No console Google Cloud , acesse a página do Cloud SQL.

    Acessar o Cloud SQL

  2. Selecione uma instância na lista.

  3. No menu de navegação, clique em Cloud SQL Studio.

  4. Faça login no Studio usando a autenticação do Identity and Access Management (IAM).

  5. No painel "Explorer", ao lado de Agentes de dados, clique em Ver ações.

  6. Clique em Excluir agente.

  7. Na caixa de diálogo de confirmação Excluir agente, insira o nome do agente.

  8. Clique em Confirmar para excluir o agente.

A seguir