Visão Geral do Agent Studio

O Agent Studio é o ambiente visual do HighLevel para construir agentes de IA inteligentes. Ele permite que você projete como um agente é acionado, como ele processa informações, como toma decisões e quais ações ele executa, tudo dentro de um canvas flexível baseado em nós.

Este artigo é destinado a usuários que estão explorando o Agent Studio pela primeira vez e desejam entender sua estrutura, propósito e componentes principais antes de construir automações avançadas.

SUMÁRIO

• O que é o Agent Studio?
• Principais Benefícios do Agent Studio
• Entendendo a Interface do Agent Studio
• Dashboard do Agent Studio
• Criando um Novo Agente
• Biblioteca de Templates de Agentes
• O Builder Canvas
• Start Trigger
• Categorias de Nós
• Variáveis e Global Prompt
• Testando e Publicando
• Começando com o Agent Studio
• Perguntas Frequentes
• Artigos Relacionados

O que é o Agent Studio?

O Agent Studio é um construtor visual usado para criar agentes com inteligência artificial que podem responder a eventos, interagir com usuários, recuperar informações, gerar conteúdo e conectar-se a sistemas externos.

Ao contrário de automações simples baseadas em regras, os agentes construídos no Agent Studio podem interpretar entradas, tomar decisões contextuais, rotear conversas dinamicamente e usar ferramentas como pesquisa de conhecimento ou APIs.

Cada agente é construído usando nós conectados em um canvas, permitindo que você defina como ele começa, como processa informações e como completa sua tarefa.

Principais Benefícios do Agent Studio

• Visual AI Builder: Projete o comportamento do agente usando um canvas de arrastar e soltar.
• Event-Based Execution: Acione agentes usando eventos de CRM, como mensagens de chat, envios de formulários ou tags de leads.
• Flexible Decision Logic: Roteie conversas com base na detecção de intenção por IA ou em condições baseadas em regras.
• Integrated Knowledge & Tools: Conecte sua Knowledge Base, pesquise na web ou faça chamadas de API.
• Multi-Modal Output: Gere texto, imagens, áudio ou vídeo dentro de um único fluxo.
• Structured Data Collection: Capture e-mails, números de telefone e seleções de usuários durante as interações.

Entendendo a Interface do Agent Studio

Dashboard do Agent Studio

Ao navegar para AI Agents → Agent Studio, você verá uma lista de todos os agentes em sua conta.

O dashboard permite que você:

• Visualize agentes existentes
• Verifique o status (Draft ou Published)
• Veja quando foram criados ou atualizados pela última vez
• Organize agentes em pastas
• Crie um novo agente
• Navegue pelos templates disponíveis

Esta é a área de gerenciamento central para seus agentes de IA.

Criando um Novo Agente

No dashboard, clique em Create Agent.

Você pode escolher:

• Começar do zero
• Usar um template da Template Library

Começar do zero oferece um canvas em branco. Usar um template fornece uma estrutura pré-construída que você pode personalizar.

Biblioteca de Templates de Agentes

A Template Library oferece modelos de agentes prontos, projetados para casos de uso comuns.

Em vez de construir a partir de um canvas em branco, você pode:

• Navegar por templates categorizados
• Visualizar como o agente é estruturado
• Instalar um template em sua conta
• Modificar qualquer parte do fluxo após a instalação

Os templates geralmente incluem triggers predefinidos, nós de IA, lógica de roteamento e ações. Para usuários iniciantes, os templates são frequentemente a maneira mais rápida de entender como os agentes são estruturados e conectados.

O Builder Canvas

Quando você abre ou cria um agente, você entra no builder canvas visual.

É aqui que você:

• Arrastar e conectar nós
• Definir a lógica de execução
• Configurar cada etapa do seu agente

Os agentes são construídos conectando nós da esquerda para a direita, começando com um trigger e terminando com uma ação ou ponto de conclusão. As conexões entre os nós definem como o agente se comporta em cenários reais.

Start Trigger

Todo agente começa com um Start Trigger.

O Start Trigger define quando o agente deve ser executado. Exemplos comuns incluem:

• Chat Message
• Form Submission
• Lead Tag Added

Sem um trigger, o agente não será executado. O trigger garante que o agente responda apenas quando condições específicas forem atendidas.

Categorias de Nós

No Agent Studio, tudo no canvas é construído usando nós. Um nó é um bloco de construção que executa uma função específica, como iniciar o agente, gerar uma resposta, coletar informações ou conectar-se a outro sistema. Ao conectar nós, você define como seu agente se comporta do início ao fim.

AI Agent: O nó AI Agent é o "cérebro" do seu fluxo. Ele lê a entrada recebida, entende o contexto e gera respostas inteligentes com base nas instruções que você fornece. Por exemplo, se um usuário perguntar sobre preços, este nó pode interpretar a pergunta e gerar uma resposta relevante.

Sequential: O nó Sequential permite agrupar várias etapas e executá-las em uma ordem fixa. Isso é útil quando certas ações devem acontecer uma após a outra, como coletar um e-mail primeiro e depois enviar uma mensagem de confirmação.

End Node: O End Node marca onde a execução do agente para. Uma vez que o fluxo atinge este nó, a interação está completa.

Router: O nó Router ajuda o agente a escolher entre diferentes caminhos com base em condições ou intenção detectada por IA. Pense nele como um ponto de decisão: se um usuário perguntar sobre suporte, vá por um caminho; se perguntar sobre vendas, vá por outro.

Search Knowledge Base: Este nó permite que o agente procure informações armazenadas em sua Knowledge Base conectada. Por exemplo, ele pode extrair respostas diretamente da documentação da sua empresa.

Search Web: O nó Search Web permite que o agente colete informações de fontes online quando necessário. Isso é útil ao responder a perguntas que exigem dados publicamente disponíveis ou atuais.

MCP Server: O nó MCP Server conecta seu agente a servidores de ferramentas externas suportados. Isso permite integrações avançadas onde o agente pode usar sistemas externos para realizar ações especializadas.

API Call: O nó API Call permite que seu agente envie ou receba informações de outros aplicativos. Por exemplo, ele pode enviar dados de leads para outro sistema ou recuperar detalhes de clientes.

Audio Generation: Este nó permite que o agente gere respostas de áudio faladas com base em instruções dentro do fluxo.

Image Generation: O nó Image Generation cria imagens com base em prompts descritivos, útil para conteúdo visual dinâmico.

Text Generation: O nó Text Generation produz conteúdo escrito, como mensagens, resumos ou respostas estruturadas.

Email Address: Este nó coleta o endereço de e-mail de um usuário durante uma interação em um formato estruturado.

Phone Number: O nó Phone Number coleta o número de telefone de um usuário em um formato padronizado para armazenamento preciso.

Single Choice: O nó Single Choice apresenta opções predefinidas para o usuário selecionar, ajudando a guiar a tomada de decisões estruturada.

Text Input: O nó Text Input coleta respostas abertas dos usuários, permitindo que o agente reúna informações detalhadas.

Variáveis e Global Prompt

Na parte superior do builder, você encontrará ferramentas de configuração adicionais que controlam como seu agente se comporta em todo o fluxo.

Variáveis

Variáveis atuam como placeholders reutilizáveis que armazenam informações. Em vez de repetir o mesmo valor em vários lugares, você o define uma vez e o referencia em todo o agente. Por exemplo, você pode armazenar um nome de empresa e usá-lo consistentemente em todas as respostas.

Global Prompt

O Global Prompt define instruções abrangentes que guiam o comportamento do agente. Ele define o tom, a personalidade e as regras que o agente deve seguir em cada interação.

Testando e Publicando

Antes de ativar um agente, você pode:

• Usar o recurso Test para simular a execução
• Salvar alterações como um rascunho (draft)
• Publicar o agente quando estiver pronto

Um agente deve ser publicado para responder a triggers do mundo real.

Começando com o Agent Studio

Para criar seu primeiro agente:

• Navegue até AI Agents → Agent Studio
• Clique em Create Agent
• Escolha começar do zero ou instalar um template
• Adicione um Start Trigger
• Arraste um nó AI Agent para o canvas e conecte-o
• Use Test para simular o comportamento
• Salve e Publique o agente

Perguntas Frequentes

Q: Os agentes são executados automaticamente?

Os agentes são executados apenas quando suas condições de trigger configuradas são atendidas.

Q: Como o Agent Studio é diferente dos Workflows?

Workflows seguem regras de automação predefinidas. Os agentes podem interpretar entradas e tomar decisões dinâmicas usando IA.

Q: Preciso publicar um agente para que ele funcione?

Sim. Um agente deve ser publicado para responder a eventos reais.

Q: Os agentes podem se integrar com sistemas externos?

Sim. Os nós API Call e MCP Server permitem integrações externas.

Q: Os agentes podem gerar conteúdo além de texto?

Sim. O Agent Studio suporta a geração de imagens, áudio e vídeo.

Artigos Relacionados

• Roteamento Baseado em Intenção no Agent Studio
• Como Configurar Triggers do Agent Studio
• Biblioteca de Templates do Agent Studio