Este documento descreve como criar um agente de dados no Cloud SQL para MySQL 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
- Adicione um usuário do IAM ou uma conta de serviço ao cluster no nível da instância. Para mais informações, consulte Gerenciar usuários com autenticação de banco de dados do IAM.
- Conceda os papéis
cloudsql.studioUserecloudsql.instanceUserao 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. Também é necessário conceder privilégios de banco de dados a um usuário do IAM ou a uma conta de serviço. Para mais informações, consulte Conceder privilégios de banco de dados a um
usuário individual do IAM ou a uma conta de serviço.
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
INSTANCE_ID pelo ID da instância do Cloud SQL.
Criar um agente de dados
Para criar um agente de dados, siga estas etapas:
No console Google Cloud , acesse a página do Cloud SQL.
Selecione uma instância na lista.
No menu de navegação, clique em Cloud SQL 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. Você pode selecionar uma das seguintes regiões compatíveis:
- us-central1
- us-east1
- europe-west4
- asia-southeast1
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 Cloud SQL.
Selecione uma instância na lista.
No menu de navegação, clique em Cloud SQL 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 Cloud SQL.
Selecione uma instância na lista.
No menu de navegação, clique em Cloud SQL 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.