Visão geral do Agente

Um Agente é uma IA que trabalha de forma autônoma. Você descreve o objetivo dele, declara as entradas que ele recebe e as saídas que espera, e dá a ele skills, ajudantes, arquivos de referência e integrações. O Agente então decide que passos dar e conclui a tarefa por conta própria, em uma única execução ou em uma conversa. Esta seção percorre cada parte de um Agente em detalhe. Se você nunca criou um, comece por Seu primeiro Agente e volte aqui depois.

​

Quando usar um Agente

Um Agente custa mais por execução do que um Canvas e é mais difícil de tornar previsível do que um Workflow. Recorra a ele quando os próximos passos dependem do que o Agente encontra no meio do trabalho. Um Workflow ainda pode usar um Agente em uma das suas etapas (veja Executando um Agente e obtendo resultados).

​

O exemplo que acompanha a seção

As páginas desta seção constroem o mesmo Agente: um assistente de contratos para um time jurídico. Ele recebe um arquivo de contrato e uma pergunta, lê o contrato, responde à pergunta e sinaliza cláusulas que parecem arriscadas. As saídas dele são answer (um texto) e risky_clauses (uma lista de textos). Ele aparece em todas as páginas, para que as partes se encaixem.

​

Os dois harnesses

O harness é o motor que executa o Agente. Você o escolhe no diálogo Novo agent, e ele não pode ser alterado depois que o Agente é criado. Uma regra simples: comece com Lightweight quando a tarefa é bem delimitada, a latência importa ou você quer um modelo de um provedor específico. Escolha Claude Code quando o Agente precisa lidar com tarefas longas e abertas, com muitos arquivos, skills e subagents.

​

Anatomia da página do Agente

Assim como um Canvas, a página do Agente tem as experiências Craft, Test e Usage no centro superior. Esses três nomes ficam em inglês em todos os idiomas. Cabeçalho. O caminho mostra o Workspace, o Projeto e o título do Agente (clique nele para renomear). O menu … ao lado do título tem Conectar via API (depois de publicado), Agendar, Tornar público, Credenciais do Agent (administradores), as ações de template (administradores), Renomear e Excluir. À direita ficam o seletor de branch (main por padrão), o botão da Tela CLI, o Histórico de Versões, Compartilhar link e o botão Publicar. Barra lateral esquerda. A experiência Craft é organizada em seções:

• Objetivo: as instruções que o Agente segue, e o modelo que ele usa
• Entradas: as variáveis que o Agente recebe a cada execução, como texto ou arquivos
• Saídas: o resultado estruturado que você espera de volta, se houver
• Skills: instruções reutilizáveis que o Agente carrega quando uma tarefa precisa delas
• Subagents: ajudantes para os quais o seu Agente pode delegar partes do trabalho
• Arquivos: documentos de referência que o Agente pode ler enquanto trabalha
• Integrações: serviços externos que o Agente pode chamar sem nunca ver as credenciais

Este é o layout de um Agente Claude Code. Um Agente Lightweight tem a própria barra lateral, descrita em A página do Agente Lightweight. Centro. O editor da seção selecionada. Painel direito. Teste seu agente: preencha as Variáveis, envie uma mensagem ou clique em Executar, e acompanhe o Agente trabalhando. Veja Testando um Agente.

​

Ciclo de vida

​

Como um Agente é armazenado

Toda alteração que você faz em um Agente é salva como uma nova versão, e o Histórico de Versões permite visualizar ou restaurar qualquer uma delas. As suas últimas alterações ficam na branch main, que é o rascunho que você testa; a versão que você publica é a que roda em produção. Você também pode criar outras branches para experimentar sem mexer na main e fazer o merge depois.

​

Nesta seção