> ## 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.

# Objetivo e modelo

> Escreva as instruções que o seu Agente segue, mencione as entradas, skills, subagents e arquivos dele, e escolha o modelo e as configurações avançadas

O **Objetivo** é a primeira seção da barra lateral e o coração do Agente: as instruções que ele lê antes de cada execução. A mesma tela traz o seletor de modelo no topo.

![Seção Objetivo com o selo do harness, o seletor de modelo e o editor com chips de entrada, skill, subagent e arquivo](https://mintcdn.com/meistrari/IBJhAp-onVS37l80/images/pt/agent/purpose.png?fit=max\&auto=format\&n=IBJhAp-onVS37l80\&q=85\&s=f4c93744459012c2235bab71025dbda0)

## Escrevendo o Objetivo

Escreva o Objetivo como você orientaria um colega novo e competente. Um bom Objetivo cobre:

* **Papel e meta**: quem o Agente é e o que conta como trabalho concluído
* **Como usar as entradas**: o que cada entrada contém e o que fazer com ela
* **Etapas e regras**: a ordem do trabalho, o que sempre fazer, o que nunca fazer
* **Quando usar cada ajudante**: qual skill, subagent ou arquivo se aplica a qual situação
* **Tom e idioma** da resposta

Deixe o formato do resultado fora do Objetivo. Os atributos que você espera de volta pertencem às [Saídas](https://docs.tela.com/pt/agent/inputs-and-outputs.md#saidas), onde o Tela os garante; descrevê-los no Objetivo só cria duas fontes de verdade.

Este é o Objetivo do assistente de contratos do [exemplo da seção](https://docs.tela.com/pt/agent/overview.md#o-exemplo-que-acompanha-a-secao). Os nomes destacados são menções, explicadas abaixo:

```text theme={null}
Você é um assistente de contratos do time jurídico de uma empresa de médio porte.

O contrato a analisar é o arquivo em input/contract/. A pergunta que o
advogado quer responder é <question>. Se não houver pergunta, resuma o
contrato e liste as obrigações principais.

Etapas:
1. Leia o contrato inteiro antes de responder. Nunca presuma uma cláusula.
2. Responda à pergunta citando o número da cláusula e transcrevendo o trecho relevante.
3. Revise cada cláusula contra o playbook de riscos em references/risk-playbook.md
   e sinalize as arriscadas. Para cláusulas de rescisão e responsabilidade, delegue
   a verificação a ./.claude/agents/clause-checker.md.
4. Use ./.claude/skills/clause-review/SKILL.md sempre que comparar uma cláusula
   com o padrão de mercado.

Regras: escreva no idioma do contrato, não dê aconselhamento jurídico além do
texto do contrato e diga explicitamente quando o contrato for omisso sobre um tema.
```

> [!TIP]
>
> Comece pequeno: um papel, as entradas e três ou quatro regras. Execute, leia o que o Agente fez no painel **Teste seu agente** e só então adicione skills, subagents e mais regras para os casos que deram errado.

## Mencionando entradas, skills, subagents e arquivos

Digite `@` no editor para abrir o menu de menções. Ele lista o que já existe no Agente, agrupado em **Inputs**, **Skills**, **Subagentes** e **Arquivos**. Escolha um item e ele é inserido como um chip, para que o Agente saiba exatamente a qual entrada, skill, subagent ou arquivo você se refere.

Como o menu só lista o que existe, declare as entradas e adicione as skills, subagents e arquivos primeiro, e depois escreva o Objetivo que os menciona.

O placeholder do editor lembra os atalhos: *Digite / para comandos ou @ para menções*.

> [!NOTE]
>
> **Para desenvolvedores.** Um chip é texto simples no arquivo do Objetivo. Entradas de texto são escritas como `<inputName>`, entradas de arquivo como `input/<inputName>/`, skills como o caminho do seu `SKILL.md` (por exemplo `./.claude/skills/clause-review/SKILL.md`), subagents como o caminho do arquivo deles (por exemplo `./.claude/agents/clause-checker.md`) e arquivos de referência pelo caminho. A interface só renderiza essas referências como chips quando elas são texto simples cercado por espaços ou pontuação e o alvo existe. Não as envolva em crases nem em formatação de código; se fizer isso, a página do Agente deixa de reconhecê-las.

## Salvando

As alterações no Objetivo são salvas com o controle de salvar do editor ou com `Cmd+S` (`Ctrl+S` no Windows e no Linux). Cada salvamento cria uma nova versão do Agente, que você encontra no **Histórico de Versões** (veja [Publicação e versões](https://docs.tela.com/pt/agent/publishing-and-versions.md)). Um indicador de **Alterações não salvas** aparece enquanto houver edições pendentes.

> [!WARNING]
>
> Ao alternar entre **Craft**, **Test** e **Usage**, o Tela não avisa sobre edições não salvas. Salve antes de sair do editor do Objetivo.

## Escolhendo o modelo

No topo da tela do Objetivo há um selo com o harness (**Lightweight** ou **Claude Code**) e a lista de modelos (**Selecionar modelo**). Os modelos oferecidos dependem do harness: o Lightweight lista modelos de vários provedores, o Claude Code lista modelos Claude. A troca de modelo é salva como uma nova versão, como qualquer outra edição.

Escolha o modelo mais capaz enquanto constrói, para descobrir o que o Agente consegue fazer, e só depois experimente um mais rápido ou mais barato contra os seus casos de teste.

> [!NOTE]
>
> O harness é definido na criação e não muda aqui. Para usar o outro harness, crie um novo Agente.

## Configurações avançadas (harness Claude Code)

Com o harness Claude Code, um ícone de engrenagem ao lado do modelo abre as **Configurações avançadas**. Habilitar essas funcionalidades pode gerar custos extras nas execuções do Agente.

| Configuração | O que faz |
| - | - |
| **Habilitar thinking** | Habilita o modo de raciocínio adaptativo do Agente |
| **Esforço de raciocínio** | Controla o equilíbrio entre qualidade da resposta, latência e custo: **Padrão**, **Baixo**, **Médio**, **Alto**, **Extra alto** ou **Máximo** |
| **Duração do cache de prompt** | Por quanto tempo o cache de prompt permanece ativo entre execuções: **Padrão (5 min)**, **5 minutos** ou **1 hora**. Uma hora dobra o custo de escrita do cache |
| **Habilitar workflow tool** | Em *Workflow agents*: permite que o Agente divida tarefas grandes entre subagents em paralelo |
| **Duração máxima (minutos)** | Interrompe uma execução com workflow tool depois desse tempo. O campo sugere 30 |
| **Custo máximo (USD)** | Interrompe uma execução com workflow tool depois desse gasto. O campo sugere 10 |

Clique em **Salvar** para aplicar.

![Diálogo Configurações avançadas com thinking, esforço de raciocínio, cache de prompt e workflow agents](https://mintcdn.com/meistrari/IBJhAp-onVS37l80/images/pt/agent/advanced-settings.png?fit=max\&auto=format\&n=IBJhAp-onVS37l80\&q=85\&s=a83e2fcea7774fbcdc140a232f37de45)

## A página do Agente Lightweight

Um Agente Lightweight tem uma página diferente da de um Agente Claude Code. No topo da barra lateral, um seletor alterna entre **Menu** (configure o agente passo a passo) e **Arquivos** (edite os arquivos do agente diretamente). Na visualização **Menu**, a barra lateral tem:

* **Objetivo**: as instruções e o modelo, como descrito acima.
* **Configurações**: quatro abas, **Geral**, **Integrações**, **Agendamentos** e **Compartilhamento**. Em **Geral** ficam o **Modelo padrão** (usado em toda execução, a menos que outro modelo seja escolhido no chat), o **Harness** (somente leitura, definido pelo template do agente), a **Temperatura** (de 0 a 2, quando o modelo aceita), o **Limite de compactação** (as mensagens mais antigas são resumidas quando o contexto chega a esse número de tokens, mínimo de 1.000) e o **Modo chat** (mantém a conversa aberta depois da primeira resposta).
* **Referências**: arquivos que o Agente lê em toda execução, como modelos e playbooks. Clique em **Enviar** para adicioná-los e cite-os no Objetivo com `@`.
* **Entradas** e **Saídas**: iguais às de um Agente Claude Code. Veja [Entradas e saídas](https://docs.tela.com/pt/agent/inputs-and-outputs.md).
* **Ferramentas**: as ferramentas do Agente, descritas abaixo.

![Configurações de um Agente Lightweight, aba Geral, com modelo, harness, temperatura, limite de compactação e modo chat](https://mintcdn.com/meistrari/IBJhAp-onVS37l80/images/pt/agent/lightweight-settings.png?fit=max\&auto=format\&n=IBJhAp-onVS37l80\&q=85\&s=9db536fce1d9bbb29c6365de8a92f166)

### Ferramentas

Cada ferramenta abre a sua própria tela de configuração.

**Super search** controla como o Agente pesquisa na web. Escolha **Busca nativa** (a busca embutida do modelo) ou **Super Search**, que substitui a busca padrão por uma busca em vários provedores. Com a Super Search ativa, escolha os **Provedores** (**AWS**, **Google**, **OpenAI**; selecione pelo menos um) e, em **Resultado**, o que cada busca devolve: **Resumo com links** ou **Só links**.

**Leitura de documentos** controla como o Agente lê documentos. **Extrair texto** lê a camada de texto de PDFs e arquivos do Office: é mais rápido, mas ignora páginas escaneadas. **Extrair texto e reconhecer páginas escaneadas** adiciona OCR para imagens e PDFs escaneados: é mais lento e consome mais créditos.

**Splitter** permite que o Agente identifique e extraia os documentos lógicos dentro de um PDF. Ative-o e, se quiser, adicione instruções para a separação (até 2.000 caracteres), usadas sempre ou apenas como alternativa.

**Adicionar ferramenta** transforma um Workflow ou Canvas publicado em uma ferramenta. Escolha o recurso e, se quiser, escreva uma descrição. Os inputs e as descrições deles vêm do recurso publicado, e o Agente os usa para decidir quais valores enviar.

![Página de um Agente Lightweight com a ferramenta Super search aberta, mostrando Busca nativa e Super Search](https://mintcdn.com/meistrari/IBJhAp-onVS37l80/images/pt/agent/tools-search.png?fit=max\&auto=format\&n=IBJhAp-onVS37l80\&q=85\&s=33be63c075bed839e27cc4a676a53dda)

## Configurações de conversa

Dois interruptores no cabeçalho da seção **Entradas** mudam o comportamento de uma execução: **Chat** (conversas com várias rodadas) e **Compactar automaticamente** (resumir conversas longas). Eles são descritos em [Entradas e saídas](https://docs.tela.com/pt/agent/inputs-and-outputs.md#chat-e-compactar-automaticamente).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.