Pular para o conteúdo principal

​
O que é um Agente

Um Agente é uma IA que trabalha de forma autônoma. Em vez de um único Prompt, você define um propósito, as entradas que ele recebe, as saídas que você espera e as ferramentas que ele pode usar. O Agente então raciocina, usa essas ferramentas e conclui a tarefa por conta própria. Use um Agente quando você não consegue definir as etapas de antemão: os próximos passos dependem do que o Agente encontra no meio do trabalho, ele precisa chamar serviços externos ou trabalha por meio de uma conversa de ida e volta. Para uma única instrução bem definida, um Canvas é mais simples. Se você consegue desenhar as etapas de antemão, um Workflow é mais previsível e mais fácil de testar, e ainda pode usar um Agente em uma das suas etapas.
A criação de Agentes é habilitada por Workspace. Se você não vê a opção Agent no seu Dashboard, fale com o time do Tela.

​
Criando um Agente

Diferente de Canvases e Workflows, Agentes são criados diretamente dentro de um Projeto, então eles não passam pela etapa de Rascunho. A partir do seu Dashboard:
  1. Clique em Agent
  2. No diálogo Novo agent, escolha o Projeto ao qual o Agente pertence
  3. Escolha o harness, o motor que executa o Agente: Lightweight · Tela é mais rápido e funciona com modelos de qualquer provedor, e Claude Code · Anthropic é mais minucioso em trabalhos complexos, com modelos Claude. O harness não pode ser alterado depois que o Agente é criado
  4. Clique em Continuar e escolha um template para partir dele ou comece do zero
Diálogo Novo agent com o projeto e as opções de harness
Você também pode criar um Agente a partir da página de um Projeto, pelo botão Criar.

​
Entendendo a página do Agente

Assim como um Canvas, um Agente possui as experiências Craft, Test e Usage no centro superior. A experiência Craft é organizada em seções na barra lateral esquerda:
  • Objetivo: as instruções que descrevem o que o Agente faz e como ele deve se comportar. É aqui também que você escolhe o modelo
  • Entradas: as variáveis que o Agente recebe a cada execução, como texto ou arquivos
  • Saídas: a saída estruturada que você espera de volta, se houver
  • Skills: capacidades especializadas que você adiciona para tarefas complexas ou recorrentes
  • Subagents: Agentes auxiliares para os quais o seu Agente pode delegar partes do trabalho
  • Arquivos: documentos de referência que o Agente pode consultar enquanto trabalha
  • Integrações: serviços externos que o Agente pode chamar sem nunca ver as credenciais
Página do Agente na experiência Craft
Comece apenas com Objetivo e Entradas. Adicione Skills, Subagents e Integrações depois que a execução básica funcionar como você espera.

​
Executando o seu Agente

Use o painel Teste seu agente, à direita. Preencha as Variáveis (as Entradas do Agente) e envie uma mensagem na caixa de baixo. O Agente trabalha na tarefa e responde no mesmo painel, e você pode continuar a conversa: ele mantém o contexto entre as mensagens.

​
Testando e publicando

Quando uma execução ficar boa, salve-a como caso de teste ou vá até a experiência Test e crie o primeiro teste. Cada teste tem entradas, uma saída esperada e instruções opcionais para o avaliador que julga o resultado. Quando estiver pronto, clique em Publicar. Publicar cria uma versão estável que as suas integrações usam. O seu time também pode usar o Agente publicado por meio de um App. Para chamar o Agente a partir dos seus próprios sistemas, abra o menu … e escolha Conectar via API.