> ## Documentation Index > Fetch the complete documentation index at: https://docs.tela.com/llms.txt > Use this file to discover all available pages before exploring further. # Visão geral do Agente > O que é um Agente no Tela, como os dois harnesses se diferenciam, o que você encontra na página do Agente e como ele vai da ideia à produção 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](https://docs.tela.com/pt/creating-your-first-agent.md) e volte aqui depois. ## Quando usar um Agente | Se a sua tarefa… | Use | | - | - | | Pode ser feita com uma única instrução, como extrair campos de um documento | [Canvas](https://docs.tela.com/pt/creating-your-first-canvas.md) | | Tem várias etapas que você consegue desenhar de antemão | [Workflow](https://docs.tela.com/pt/creating-your-first-workflow.md) | | Tem etapas que você não consegue definir de antemão, precisa de serviços externos ou é uma conversa | **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](https://docs.tela.com/pt/agent/running-and-results.md)). ## 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. | | **Lightweight · Tela** | **Claude Code · Anthropic** | | - | - | - | | Descrito no diálogo como | Mais rápido, funciona com modelos de qualquer provedor | Mais minucioso em trabalhos complexos, com modelos Claude | | Modelos | Modelos de vários provedores | Modelos Claude | | Configurações extras | Um layout de página próprio, com **Configurações**, **Referências** e um grupo **Ferramentas** (**Super search**, **Leitura de documentos**, **Splitter** e Workflows ou Canvases publicados como ferramentas) | **Configurações avançadas** ao lado do modelo: thinking, esforço de raciocínio, cache de prompt e subagents em paralelo | 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. ![Diálogo Novo agent com o seletor de Projeto e as opções de harness Lightweight e Claude Code](https://mintcdn.com/meistrari/jZ7VrspVjrdqJJQA/images/pt/guides/getting-started/create-agent.png?fit=max\&auto=format\&n=jZ7VrspVjrdqJJQA\&q=85\&s=23dc03c34085302951123e1cd869a5a8) ## 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](https://docs.tela.com/pt/agent/purpose-and-model.md#a-pagina-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](https://docs.tela.com/pt/agent/testing.md). ![Página do Agente na experiência Craft, com as seções da barra lateral, o editor de Objetivo e o painel Teste seu agente](https://mintcdn.com/meistrari/IBJhAp-onVS37l80/images/pt/agent/craft.png?fit=max\&auto=format\&n=IBJhAp-onVS37l80\&q=85\&s=25890e276d5b342fff84fd3a92d47f15) ## Ciclo de vida **1. Crie dentro de um Projeto** No **Dashboard**, clique em **Agent**. No diálogo **Novo agent**, escolha o Projeto, escolha o harness e clique em **Continuar**. Depois, escolha um template ou clique em **Começar do zero**. Agentes são sempre criados dentro de um Projeto, então não existe a etapa de Rascunho. **2. Craft** Escreva o [Objetivo e escolha o modelo](https://docs.tela.com/pt/agent/purpose-and-model.md), declare [Entradas e Saídas](https://docs.tela.com/pt/agent/inputs-and-outputs.md) e então adicione [Skills, Subagents e Arquivos](https://docs.tela.com/pt/agent/skills-subagents-and-files.md) e [Integrações](https://docs.tela.com/pt/agent/integrations-and-credentials.md) conforme a tarefa exigir. **3. Test** Execute no painel **Teste seu agente** e transforme as boas execuções em casos de teste na experiência **Test**. Veja [Testando um Agente](https://docs.tela.com/pt/agent/testing.md). **4. Publique** Clique em **Publicar**. A versão publicada é a que a API, os Workflows, os agendamentos e as tarefas executam; o painel de teste continua executando as suas últimas alterações. Veja [Publicação e versões](https://docs.tela.com/pt/agent/publishing-and-versions.md). **5. Execute onde o trabalho acontece** Chame-o dos seus sistemas com **Conectar via API**, adicione-o como etapa de um Workflow, agende-o ou crie tarefas para ele. Veja [Executando um Agente e obtendo resultados](https://docs.tela.com/pt/agent/running-and-results.md). > [!NOTE] > > 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. ## 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. > [!NOTE] > > **Para desenvolvedores.** Um Agente é um repositório git. Cada salvamento é um commit, e o hash do commit é o ID da versão (exibido como `VER-` seguido dos sete primeiros caracteres). O HEAD da `main` é o rascunho; o commit publicado é a produção. Você pode trabalhar no repositório localmente com a Tela CLI; veja [Publicação e versões](https://docs.tela.com/pt/agent/publishing-and-versions.md#trabalhando-localmente-com-a-tela-cli). ## Nesta seção > **[Objetivo e modelo](https://docs.tela.com/pt/agent/purpose-and-model.md)** > > Escreva as instruções, mencione entradas, skills, subagents e arquivos, escolha o modelo > **[Entradas e saídas](https://docs.tela.com/pt/agent/inputs-and-outputs.md)** > > Declare o que o Agente recebe e o formato do que ele devolve > **[Skills, subagents e arquivos](https://docs.tela.com/pt/agent/skills-subagents-and-files.md)** > > Dê ao Agente conhecimento reutilizável, ajudantes e documentos de referência > **[Integrações e credenciais](https://docs.tela.com/pt/agent/integrations-and-credentials.md)** > > Deixe o Agente chamar serviços externos e outros recursos do Tela com segurança > **[Testes](https://docs.tela.com/pt/agent/testing.md)** > > Experimente o Agente em uma conversa, monte casos de teste e leia o histórico de execuções > **[Publicação e versões](https://docs.tela.com/pt/agent/publishing-and-versions.md)** > > Versões, a branch main, publicação, restauração e compartilhamento > **[Execução e resultados](https://docs.tela.com/pt/agent/running-and-results.md)** > > Use o Agente a partir de um Workflow, da API e de tarefas, e leia os resultados This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.