Projetar agentes no Agent Studio

Esta página oferece uma visão geral de como usar o Agent Studio no Google Cloud console.

O Agent Studio é um designer visual de pouco código no Google Cloud console que simplifica o desenvolvimento de agentes. Você pode mapear visualmente os fluxos de trabalho do agente, testar respostas em tempo real e experimentar diferentes configurações antes de implantar ou fazer a transição para o código.

Este documento oferece uma visão geral do Agent Studio e explica como configurar o ambiente, criar e testar agentes e implantá-los diretamente em um ambiente de execução de produção.

Configurar o ambiente

Antes de usar o Agent Studio, configure o Google Cloud.

Ter os papéis necessários

Para receber as permissões necessárias para usar o Agent Studio, peça ao administrador para conceder a você o Usuário da plataforma de agente (roles/aiplatform.user) papel do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Criar um agente

Siga estas etapas para criar e testar um agente no Agent Studio:

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

    Acessar agentes

  2. Clique em Criar agente para abrir a tela do Agent Studio para um novo agente.

  3. Crie e salve o agente na tela do Agent Studio. Você pode alternar entre as seguintes guias:

    • Fluxo:crie o agente principal e os subagentes usando uma representação visual do fluxo de trabalho e da lógica de controle do agente.

      1. Clique em um agente para abrir o painel Detalhes dele. Você também pode clicar em Adicionar um subagente (+) para adicionar subagentes.

      2. Configure o agente principal e os subagentes no painel Detalhes:

        1. Nome:adicione um nome para ajudar a identificar o agente.

        2. Descrição:um resumo da finalidade do agente.

        3. Instruções:adicione instruções para orientar o agente.

        4. Modelo:selecione o modelo para ativar o agente.

        5. Ferramentas:clique em Adicionar ferramentas (+) para adicionar ferramentas que permitam que o agente conclua tarefas. Para mais informações, consulte Configurar e adicionar ferramentas.

      3. Para salvar o agente, clique em Salvar no cabeçalho da tela e siga as instruções. Para mais detalhes, consulte Salvar um agente.

    • Guia "Prévia":converse com o agente no painel de visualização para testar os recursos e as respostas dele. Você também pode inspecionar os eventos de cada execução para depurar o comportamento do agente. Para mais informações, consulte Inspecionar eventos do agente.

  4. Clique em Receber código para conferir o código do agente. Se você quiser continuar desenvolvendo o agente em outro lugar, copie o código e cole-o em um editor de código de sua escolha.

Quando o agente estiver concluído, você poderá implantá-lo diretamente do Agent Studio. Para mais informações, consulte Implantar um agente no Agent Studio.

Inspecionar eventos do agente

A inspeção de eventos ajuda a depurar o comportamento do agente e a solucionar problemas e rastrear o processo de raciocínio e as solicitações de modelo do agente.

Você pode depurar a execução do agente inspecionando os eventos dele na guia Prévia do Agent Studio. Essa ação permite diagnosticar problemas nos eventos individuais que o agente produz durante uma execução.

Para inspecionar eventos do agente, siga estas etapas:

  1. Abra o agente na tela do Agent Studio e abra a guia Prévia.
  2. Inicie um chat com o agente no painel de visualização para iniciar uma execução.

  3. Selecione um evento na conversa para abrir os detalhes dele. Os detalhes disponíveis dependem do evento e podem incluir o seguinte:

    • Autor:o agente ou subagente que produziu o evento. Use o autor para identificar qual subagente executou uma etapa em um fluxo de trabalho multiagente.
    • Solicitação e resposta:o payload enviado ao modelo e a resposta retornada.
    • Chamadas de ferramenta:os argumentos transmitidos às ferramentas durante a execução do agente.
    • Metadados:informações de diagnóstico adicionais, como o nome do modelo, o uso de tokens e o carimbo de data/hora.

Se o agente retornar um erro durante a visualização, o erro vai aparecer na guia Prévia para que você possa diagnosticar o problema.

Salvar um agente

É necessário salvar um agente antes de visualizá-lo ou implantá-lo, porque um agente não salvo ainda não tem uma identidade. Para salvar um agente pela primeira vez:

  1. Na tela do Agent Studio, clique em Salvar.

  2. Na caixa de diálogo Salvar agente, insira um nome do agente.

  3. Clique em Salvar.

Após o primeiro salvamento, o Agent Studio salva automaticamente todas as outras alterações feitas. Se você tentar sair da tela antes de salvar um novo agente, o Agent Studio vai pedir que você o salve primeiro.

Configurar e adicionar ferramentas no Agent Studio

Você pode configurar as seguintes ferramentas para o agente:

  • Pesquisa Google:permite que o agente faça pesquisas na Web usando a Pesquisa Google. Ativado por padrão.

  • Contexto do URL:permite que o modelo analise URLs de comandos enviados ao agente. Ativado por padrão.

  • Repositório de dados do Agent Search:clique em Adicionar (+) para permitir que o agente acesse informações indexadas no repositório de dados do Agent Search.

    Se você não tiver um repositório de dados, consulte Introdução à pesquisa personalizada para criar um. Em seguida, conceda acesso à conta de serviço ao Agent Search:

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

      Acessar o Identity and Access Management (IAM)

    2. Clique em Conceder acesso.

    3. No campo Novos principais, insira as seguintes informações da conta de serviço:

      service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com.

    4. Selecione + Adicionar papéis. Pesquise e selecione Usuário do Discovery Engine. Clique em Aplicar e em Salvar.

  • Servidor MCP:conecte um servidor do Protocolo de Contexto de Modelo (MCP) diretamente.

    1. Para adicionar ferramentas MCP conectando-se a um servidor MCP, clique em Adicionar (+) ao lado de Servidor MCP.
    2. Nome de exibição do MCP:insira um nome para o servidor MCP.
    3. URL do endpoint:insira um URL do endpoint para o servidor MCP.
    4. Autenticação:preenchida automaticamente como Nenhuma. O Agent Studio só oferece suporte a servidores MCP que não exigem autenticação.

    O agente pode usar todas as ferramentas no servidor MCP conectado.

Implantar um agente no Agent Studio

Depois de criar e visualizar um agente, você pode implantá-lo na produção. Siga estas etapas para implantar um agente no Agent Studio:

  1. Na página da lista Agentes, clique no agente que você quer implantar. A página de detalhes do agente aparece para o agente selecionado.
  2. Clique em Implantar para abrir a caixa de diálogo Implantar em uma instância do Agent Runtime.

  3. (Opcional) Edite o Nome de exibição ou a Descrição do agente.

  4. Selecione uma região de implantação na lista de regiões disponíveis e clique em OK.

  5. Clique em Implantar.

A implantação cria uma nova instância de ambiente de execução e pode levar até cinco minutos para ser concluída. Após a conclusão, uma mensagem aparece na guia Fluxo da tela do Agent Studio. O agente agora está disponível na produção e pode ser integrado com segurança aos apps externos.

Conferir um agente implantado

Para conferir o agente implantado:

  1. No Google Cloud console, acesse a página Implantações da Agent Platform.

    Acessar "Implantações"

  2. Use a lista Região para filtrar por região de implantação.

  3. Os agentes implantados que fazem parte do projeto selecionado aparecem na lista.

  4. Clique no nome do agente especificado. A página Métricas do agente é aberta.

  5. Selecione a guia Simulador para testar o agente.

  6. Insira uma consulta de teste no painel de chat para verificar se o agente é executado corretamente.

Para mais informações sobre as métricas disponíveis para o agente, consulte Conferir métricas do agente implantado.