Faça a gestão de agentes de dados no Cloud SQL for PostgreSQL Studio

Este documento descreve como criar um agente de dados no Cloud SQL for PostgreSQL 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

Conclua 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 Cloud SQL

  • Certifique-se de que tem acesso a uma instância do Cloud SQL existente ou crie uma nova. Para mais informações, consulte o artigo Crie instâncias para o Cloud SQL.
  • 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

Conceda autorização executesql à instância do Cloud SQL

Para conceder a autorização executesql à instância do Cloud SQL e ativar a API Cloud SQL Data, 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.

Crie um agente de dados

Para criar um agente de dados, siga estes passos:

  1. Na Google Cloud consola, aceda à página do Cloud SQL.

    Aceder ao Cloud SQL

  2. Selecione uma instância na lista.

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

  4. Inicie sessão no Studio através da autenticação da gestão de identidade e de acesso (IAM).

  5. No painel do explorador, junto a Agentes de dados, clique em Ver ações.

  6. Clique em Criar agente.

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

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

  9. Opcional. Clique em Mostrar opções avançadas e, em Selecionar uma localização, selecione uma região para armazenar o contexto do agente. Pode selecionar a partir da seguinte lista de regiões suportadas:

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

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

  1. Na Google Cloud consola, aceda à página do Cloud SQL.

    Aceder ao Cloud SQL

  2. Selecione uma instância na lista.

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

  4. Inicie sessão no Studio através da autenticação da gestão de identidade e de acesso (IAM).

  5. No painel do explorador, junto a 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 secção Carregar ficheiro de contexto do agente e selecione o ficheiro de contexto do agente.

  9. Clique em Guardar.

Elimine um agente de dados

Para eliminar um agente de dados, siga estes passos:

  1. Na Google Cloud consola, aceda à página do Cloud SQL.

    Aceder ao Cloud SQL

  2. Selecione uma instância na lista.

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

  4. Inicie sessão no Studio através da autenticação da gestão de identidade e de acesso (IAM).

  5. No painel do explorador, junto a Agentes de dados, clique em Ver ações.

  6. Clique em Eliminar agente.

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

  8. Clique em Confirmar para eliminar o agente.

O que se segue?