> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Modelos e ferramentas

> Escolha o modelo e as ferramentas que o agente de cada etapa do workflow usa, e defina quais chamadas de ferramentas precisam de aprovação.

Cada etapa de um [workflow](https://docs.enclave.ai/pt-br/workflows/overview.md) executa um agente: um modelo com instruções e um conjunto de ferramentas. Você os define na aba **Agents** da proposta de workflow ao [criar um workflow](https://docs.enclave.ai/pt-br/workflows/create.md).

## Modelos

Escolha o modelo e o **Reasoning level** de cada agente na aba **Agents**. Modelos maiores e níveis de raciocínio mais altos lidam com tarefas mais difíceis, mas são mais lentos e usam mais créditos.

## Ferramentas

| Grupo | Para que serve |
| - | - |
| **Code & repositories** | Ler e pesquisar código, executar comandos em um sandbox com o repositório baixado, abrir pull requests e salvar relatórios e arquivos |
| **Findings & intelligence** | Ler e triar achados, e ler a inteligência de CVEs e o Threat Feed |
| **Cloud & architecture** | Consultar o grafo dos seus recursos de nuvem e da exposição deles |
| **Knowledge & memory** | Pesquisar na web, e salvar e pesquisar memórias |
| **Actions** | Criar issues no Linear ou no Jira |

### Aprovação

Uma ferramenta que faz alterações mostra a configuração **Approval** quando você a seleciona:

* **Don't ask: runs now:** o agente chama a ferramenta na hora.
* **Ask later: runs once OK'd:** a chamada é salva e o agente continua. A chamada roda quando uma pessoa clica em **Approve**, mesmo depois que a execução termina.
* **Ask first: waits for OK:** cada chamada espera até que uma pessoa clique em **Approve** ou **Deny**.

Veja [Aprovar chamadas de ferramentas](https://docs.enclave.ai/pt-br/workflows/runs.md#aprovar-chamadas-de-ferramentas).

> [!WARNING]
>
> Páginas da web e conteúdo de repositórios são escritos por outras pessoas e podem enganar um agente. Antes de dar a um agente que os lê ferramentas que fazem alterações, configure essas ferramentas como **Ask first: waits for OK**.

### Criar issues no Linear ou no Jira

Um workflow pode criar issues no Linear ou no Jira onde você escolher.

**1. Conecte o rastreador**

Conecte o [Linear](https://docs.enclave.ai/pt-br/integrations/linear.md) ou o [Jira](https://docs.enclave.ai/pt-br/integrations/jira.md) em **Settings → Integrations**.

**2. Escolha onde as issues são criadas**

Na aba **Agents** de uma proposta de workflow, clique em **Edit tools** e selecione a ferramenta do Linear ou do Jira. Escolha uma conta e, depois, o time ou projeto para onde as issues vão.

Um workflow salvo cria cada problema uma única vez. Quando uma execução posterior encontra um problema que já registrou, ela reutiliza a issue existente.

### Salvar relatórios e arquivos

Um agente pode salvar uma entrega, como um relatório, um CSV ou um PDF, na aba **Outputs** da execução. Ao [criar o workflow](https://docs.enclave.ai/pt-br/workflows/create.md), diga ao Research o que entregar, por exemplo "salve um relatório em Markdown com o que você encontrou". Veja [Resultados](https://docs.enclave.ai/pt-br/workflows/runs.md#resultados).

## Abrir pull requests

Um agente pode entregar as alterações como um pull request. Ao [criar o workflow](https://docs.enclave.ai/pt-br/workflows/create.md), peça isso ao Research, por exemplo "abra um pull request com a correção". A proposta então dá a esse agente acesso de escrita ao repositório da execução.

* O acesso de escrita só funciona em uma execução de workflow em um único repositório.
* Não há etapa de aprovação. Um agente com acesso de escrita pode fazer push sempre que o workflow é executado.
* As regras de push do repositório continuam valendo.

> [!WARNING]
>
> O agente lê o conteúdo do repositório e executa os próprios scripts do repositório. Um conteúdo que engane o agente pode usar o acesso dele de forma indevida. Dê acesso de escrita só aos agentes que precisam dele.


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