> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.
# ElevenAgents Architect
## Visão geral
O ElevenAgents Architect é o assistente de IA integrado ao ElevenAgents. Você descreve o que quer em linguagem simples, e o Architect lê a configuração, as conversas e os resultados de teste do seu agente, faz a alteração e a valida com testes antes de você decidir se vai publicá-la.
> **Note**
>
> O Architect é um assistente de IA e pode cometer erros. Seus resultados, incluindo alterações em prompts,
> procedimentos, ferramentas, bases de conhecimento, guardrails e testes, são propostas para você revisar, não
> resultados verificados. Você é responsável por revisar, testar e aprovar cada alteração antes que ela
> chegue aos chamadores ativos. O modo de aprovação automática (desativado por padrão) dispensa sua aprovação para ações que incluem
> mesclar branches e alterar divisões de tráfego, então use esse modo por sua conta e risco e apenas para tarefas
> nas quais você tem confiança. Consulte [Permissões, aprovações e rascunhos](/docs/pt/eleven-agents/operate/architect/authentication) para mais informações.
O Architect trabalha com os mesmos objetos que você edita manualmente: o prompt do sistema, procedimentos, workflow, ferramentas, base de conhecimento, guardrails, testes, branches e propostas de mesclagem. Ele não tem uma configuração oculta separada. Cada alteração que ele faz aparece no mesmo rascunho, diff e histórico de versões que uma alteração feita por você.
## Para que serve o ElevenAgents Architect
O Architect é mais útil para melhorar um agente que você já implantou. Ele foi criado em torno deste ciclo:
```mermaid
flowchart LR
Prompt["Prompt
Your requests"]
subgraph Architect
Triage["Triage
Flagged issues"]
Draft["Draft
Staged changes"]
Validate["Validate
Tests + simulations"]
Propose["Propose
Merge proposal"]
end
Deploy["Deploy
Traffic split"]
Observe["Observe
Agent-flagged issues"]
Prompt --> Triage --> Draft --> Validate --> Propose --> Deploy --> Observe
Observe --> Triage
Propose ~~~ Observe
```
1. **Investigar.** Leia conversas reais, insights do Spotlight, alertas, tickets de triagem e testes com falha para descobrir o que está dando errado e por quê.
2. **Alterar.** Edite o prompt, um procedimento, uma ferramenta, a base de conhecimento ou os guardrails. As alterações na configuração do agente são preparadas como um rascunho não publicado, nunca aplicadas diretamente aos chamadores ativos.
3. **Validar.** Escreva testes e simulações para a alteração e execute-os na mesma conversa, antes que você seja solicitado a publicar qualquer coisa.
4. **Propor.** Envie a alteração para sua revisão: você publica o rascunho, e o Architect pode abrir uma [proposta de mesclagem](/docs/pt/eleven-agents/operate/architect/proposals) para um colega aprovar e sugerir uma pequena divisão de tráfego para testá-la em chamadas ativas.
O Architect também cria novos agentes a partir de uma descrição, responde a dúvidas sobre o produto e orienta você pelo dashboard.
Consulte [Como o Architect funciona](/docs/pt/eleven-agents/operate/architect/how-it-works) para ver um exemplo completo desse ciclo, mostrando cada ferramenta chamada pelo Architect.
## ElevenAgents Architect e Spotlight
O [Spotlight](/docs/pt/eleven-agents/dashboard/spotlight) e o Architect têm funções diferentes.
| Produto | Função | O que faz |
| --------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Spotlight | Observa e recomenda | Monitora as conversas de um agente e apresenta um resumo semanal, investigações sugeridas, alertas em tempo real e recomendações de configuração. |
| Architect | Cria e corrige | Investiga uma dúvida ou descoberta do Spotlight com base nos dados subjacentes, altera o agente, escreve e executa testes e prepara a alteração para sua revisão. |
Os cards do Spotlight encaminham você para o Architect com botões como **Analisar com o Architect** e **Investigar com o Architect**. Consulte [Iniciar uma conversa](/docs/pt/eleven-agents/operate/architect/entry-points#spotlight) para saber o que cada encaminhamento envia.
## Disponibilidade
O Architect está em alpha. Algumas áreas, como a aba Architect por agente e a fila de triagem, estão sendo disponibilizadas gradualmente e talvez ainda não apareçam em todos os workspaces. O uso do Architect é gratuito durante o período alpha, que vai até outubro de 2026. Durante o alpha, as conversas com o Architect não contam para os minutos de agente nem para o custo de LLM do seu workspace. Consulte a [página de preços](https://elevenlabs.io/pricing) para ver os termos após o fim do alpha.
Alguns limites se aplicam:
* Anexar arquivos no compositor requer um plano Creator ou superior.
* Uma sessão inativa do Architect termina após 5 minutos, ou 15 minutos nos planos Enterprise. Você pode continuar a conversa pelo histórico de chat.
* A análise de conversas é limitada a 100 conversas analisadas por usuário por minuto.
Consulte [Limitações e perguntas frequentes](/docs/pt/eleven-agents/operate/architect/faq) para saber o que o Architect ainda não faz.
## Privacidade e retenção de dados
> **Warning**
>
> As conversas com o Architect não são cobertas pelo Modo de Retenção Zero (ZRM). Evite compartilhar informações pessoais ou
> confidenciais nas mensagens para o Architect.
Seus chats com o Architect são privados para você. Seus colegas não podem abri-los, mesmo quando um chat foi iniciado a partir de um ticket de triagem compartilhado. Para saber o que o ZRM cobre, consulte [Modo de Retenção Zero](/docs/pt/eleven-agents/customization/privacy/zrm).
## Saiba mais
#### [Iniciar uma conversa](/docs/pt/eleven-agents/operate/architect/entry-points)
Todos os lugares em que você pode abrir o Architect e o contexto que cada um envia.
#### [Como o ElevenAgents Architect funciona](/docs/pt/eleven-agents/operate/architect/how-it-works)
O que o Architect sabe, como ele investiga e um exemplo do ciclo de melhoria.
#### [O que o ElevenAgents Architect pode alterar](/docs/pt/eleven-agents/operate/architect/capabilities)
A lista completa do que o Architect pode ler e editar e do que precisa da sua aprovação.
#### [Propostas e validação](/docs/pt/eleven-agents/operate/architect/proposals)
Como as alterações do Architect são testadas, revisadas e implementadas.
#### [Permissões, aprovações e rascunhos](/docs/pt/eleven-agents/operate/architect/authentication)
Como o Architect age em seu nome e prepara alterações com segurança.
#### [Personalizar o ElevenAgents Architect](/docs/pt/eleven-agents/operate/architect/customization)
Dê ao Architect um contexto duradouro sobre seu agente e sua forma de trabalhar.
#### [Claude, Cursor e outros assistentes de IA](/docs/pt/eleven-agents/operate/architect/external-assistants)
Gerencie agentes fora do dashboard da ElevenLabs.
#### [Limitações e perguntas frequentes](/docs/pt/eleven-agents/operate/architect/faq)
O que o Architect ainda não faz e dúvidas comuns.