# Failproof AI: Brazilian Portuguese

> Trace agent behavior, find failures with audits, and prevent repeat failures with deployed policies.

## Brazilian Portuguese

### Start

#### Start here

- [Torne seu agente à prova de falhas](https://docs.befailproof.ai/pt-br/index.md): Observabilidade e controle para cada ambiente em que seus agentes operam — CLIs de codificação, gateways de chat, assistentes auto-hospedados e seus próprios agentes instrumentados.
- [Início Rápido](https://docs.befailproof.ai/pt-br/start/quickstart.md): Capture uma sessão de agente, encontre uma falha e comece a preveni-la.
- [Harnesses de agentes](https://docs.befailproof.ai/pt-br/reference/harnesses.md): Capture sessões e aplique políticas em todos os 12 harnesses de agentes suportados.
- [Assistente Failproof](https://docs.befailproof.ai/pt-br/sessions/assistant.md): Analise e opere o Failproof AI em linguagem natural, desde perguntas e consultas até dashboards e auditorias.
- [Execute sua primeira verificação de falha](https://docs.befailproof.ai/pt-br/start/first-audit.md): Crie uma auditoria pelo painel Cloud ou pela CLI fp e revise os primeiros resultados encontrados.
- [Evite sua primeira falha com uma política](https://docs.befailproof.ai/pt-br/start/first-policy.md): Crie uma versão de política, implante-a no modo de observação e depois aplique o bloqueio.
- [Escolha sua configuração](https://docs.befailproof.ai/pt-br/start/setup.md): Escolha entre aplicação local, Failproof AI Cloud ou uma implantação corporativa.
- [Conceitos principais](https://docs.befailproof.ai/pt-br/start/concepts.md): O pequeno conjunto de conceitos utilizados em todo o Failproof AI.

##### Starter templates

- [Agentes personalizados](https://docs.befailproof.ai/pt-br/start/quickstarts/custom-agents.md): Envolva seu agente em três blocos `with` e ele começa a registrar.
- [LangChain e LangGraph](https://docs.befailproof.ai/pt-br/start/quickstarts/langchain.md): Instale, instrumente e veja seu primeiro trace.
- [CrewAI](https://docs.befailproof.ai/pt-br/start/quickstarts/crewai.md): Instale, instrumente e veja seu primeiro trace.
- [LlamaIndex](https://docs.befailproof.ai/pt-br/start/quickstarts/llamaindex.md): Instale, instrumente e veja seu primeiro trace.
- [Pydantic AI](https://docs.befailproof.ai/pt-br/start/quickstarts/pydantic-ai.md): Instale, instrumente e veja seu primeiro trace.

### Trace Agents

#### Understand every run

- [Sessões](https://docs.befailproof.ai/pt-br/sessions/overview.md): Comece com o registro completo de uma execução de agente.
- [Eventos ao vivo](https://docs.befailproof.ai/pt-br/sessions/live-events.md): Acompanhe a atividade dos agentes em tempo real durante uma sessão em execução.
- [Leia um trace](https://docs.befailproof.ai/pt-br/sessions/read-a-trace.md): Encontre o evento que mudou o curso de uma sessão do agente.
- [Modelos](https://docs.befailproof.ai/pt-br/sessions/models.md): Compare latência, tokens, uso de contexto e distribuição de tráfego entre modelos.
- [Hooks](https://docs.befailproof.ai/pt-br/sessions/hooks.md): Meça a atividade de hooks, gatilhos e latência separadamente dos resultados de políticas.
- [Decisões de política](https://docs.befailproof.ai/pt-br/sessions/policy-decisions.md): Veja quais políticas avaliaram, bloquearam, instruíram ou permitiram.
- [Ferramentas](https://docs.befailproof.ai/pt-br/sessions/tools.md): Encontre ferramentas lentas, com falhas ou usadas em excesso nas sessões de agentes.
- [Erros](https://docs.befailproof.ai/pt-br/sessions/errors.md): Agrupe erros repetidos e acesse as sessões por trás deles.
- [Métricas](https://docs.befailproof.ai/pt-br/sessions/metrics.md): Visualize métricas de magnitude como latência, custo e uso de tokens.
- [Dashboards](https://docs.befailproof.ai/pt-br/sessions/dashboards.md): Acompanhe os sinais de confiabilidade que importam para um agente ou fluxo de trabalho.
- [Queries](https://docs.befailproof.ai/pt-br/sessions/queries.md): Explore dados de sessão, evento e avaliação com SQL reutilizável.

#### Plug in your agent

- [Instrumente seu agente](https://docs.befailproof.ai/pt-br/start/integrations.md): Conecte qualquer framework de agente compatível ao Failproof AI com uma única chamada.
- [Agentes personalizados](https://docs.befailproof.ai/pt-br/start/integrations/custom-agents.md): Instrumente um agente que você mesmo escreveu, ou um framework sem adaptador.
- [LangChain e LangGraph](https://docs.befailproof.ai/pt-br/start/integrations/langchain.md): Instrumente grafos, nós, ferramentas, retrievers e chamadas de modelo com uma única chamada.
- [CrewAI](https://docs.befailproof.ai/pt-br/start/integrations/crewai.md): Instrumente crews, flows, agentes por papel, ferramentas, memória e feedback humano.
- [LlamaIndex](https://docs.befailproof.ai/pt-br/start/integrations/llamaindex.md): Instrumente workflows, steps, function agents e retrievers.
- [Pydantic AI](https://docs.befailproof.ai/pt-br/start/integrations/pydantic-ai.md): Instrumente agentes tipados, ferramentas, chamadas de modelo e retentativas.

### Find failures

#### Evaluate agents

- [Avaliar agentes](https://docs.befailproof.ai/pt-br/evaluations/overview.md): Pontue cada sessão finalizada com avaliações que você define: verificações Python hospedadas ou juízes LLM no seu próprio worker.
- [Escrever uma avaliação](https://docs.befailproof.ai/pt-br/evaluations/write.md): Descreva o que medir e deixe o assistente criar uma avaliação Python hospedada, ou escreva o código você mesmo. Juízes LLM rodam no seu próprio worker.
- [Testar uma avaliação](https://docs.befailproof.ai/pt-br/evaluations/test.md): Execute uma avaliação contra suas sessões reais antes de implantá-la. Nada é armazenado.
- [Fazer deploy e versionar uma avaliação](https://docs.befailproof.ai/pt-br/evaluations/deploy.md): Faça deploy de uma versão imutável, veja o que está em produção, publique novas versões, faça rollback e pontue sessões que você já tem.
- [Leia os resultados das avaliações](https://docs.befailproof.ai/pt-br/sessions/evaluations.md): Visualize pontuações ao longo do tempo, compare agentes e ambientes, veja por que uma sessão teve pontuação baixa e consulte o assistente.

#### Find and manage failures

- [Auditorias](https://docs.befailproof.ai/pt-br/audits/overview.md): Revise uma população definida de sessões em busca de falhas que os traces sozinhos não revelarão.
- [Auditar histórico local do agente](https://docs.befailproof.ai/pt-br/audits/local-audit.md): Escaneie históricos de CLIs de agentes suportados offline e revise comportamentos arriscados ou desnecessários localmente.
- [Configurar uma auditoria](https://docs.befailproof.ai/pt-br/audits/setup.md): Defina o objetivo, a população de sessões e o contexto de evidências de uma auditoria.
- [Contexto do agente](https://docs.befailproof.ai/pt-br/audits/agent-contracts.md): Informe às auditorias o que cada agente deve fazer, produzir e nunca fazer.
- [Executar e revisar uma auditoria](https://docs.befailproof.ai/pt-br/audits/run.md): Execute uma auditoria, verifique sua cobertura e inspecione os resultados encontrados.
- [Cadência de auditoria](https://docs.befailproof.ai/pt-br/audits/cadence.md): Escolha quando as auditorias recorrentes são executadas e quanto dados elas revisam.
- [Constatações e problemas](https://docs.befailproof.ai/pt-br/audits/findings-and-issues.md): Transforme evidências de auditoria em trabalho de remediação rastreável e com responsáveis definidos.
- [Alertas](https://docs.befailproof.ai/pt-br/audits/alerts.md): Detecte recorrências e encaminhe um incidente para os responsáveis certos.
- [Receitas de auditoria](https://docs.befailproof.ai/pt-br/audits/recipes.md): Pontos de partida para investigações comuns de falhas em agentes.

### Prevent failures

#### Prevent repeat failures

- [Policies](https://docs.befailproof.ai/pt-br/policies/overview.md): Observe, guie ou bloqueie ações de agentes antes que uma falha conhecida se repita.

#### Get a policy

- [Escrever uma política](https://docs.befailproof.ai/pt-br/policies/editor.md): Deixe o Failproof AI redigir uma política a partir de uma descoberta de auditoria, ou escreva o código-fonte você mesmo, depois revise, teste e publique.
- [Usar um pacote de políticas](https://docs.befailproof.ai/pt-br/policies/packs.md): Conecte um pacote de políticas do Failproof AI para o seu caso de uso, ou um pacote da comunidade do hub de políticas, e escolha o que ele aplica.

#### Ship a policy

- [Testar uma política](https://docs.befailproof.ai/pt-br/policies/test.md): Faça backtest de um rascunho com o tráfego que você já possui e comprove que ela bloqueia o que deve bloquear e permite o que deve permitir, antes que qualquer máquina a aplique.
- [Fazer deploy de uma política](https://docs.befailproof.ai/pt-br/policies/deploy.md): Coloque uma versão de política testada em máquinas no modo de observação, aplique a execução e confirme que todas as máquinas a receberam.
- [Versões e rollback](https://docs.befailproof.ai/pt-br/policies/rollback.md): Cada publicação gera uma versão imutável, então um rollout que interrompe trabalhos válidos do agente é desfeito reimplantando a última versão estável.
- [Publicar um pacote de políticas](https://docs.befailproof.ai/pt-br/policies/publish-a-pack.md): Distribua suas próprias políticas como uma release do GitHub que qualquer pessoa pode instalar.
- [Comportamento em caso de falha](https://docs.befailproof.ai/pt-br/policies/failure-behavior.md): Entenda o que acontece quando a avaliação de políticas ou o daemon local está indisponível.

### Admin

#### Operate Failproof AI

- [Administração](https://docs.befailproof.ai/pt-br/admin/overview.md): Gerencie acesso, uso, organizações e segurança sem misturá-los ao fluxo de trabalho de confiabilidade.
- [Uso](https://docs.befailproof.ai/pt-br/admin/usage.md): Inspecione o consumo da organização e a janela de faturamento ativa.
- [Chaves e permissões](https://docs.befailproof.ai/pt-br/admin/keys-and-permissions.md): Crie chaves de API com escopo definido para máquinas, automação e operadores.
- [Usuários e organizações](https://docs.befailproof.ai/pt-br/admin/users-and-organizations.md): Controle membros e mantenha os dados e ações de cada organização isolados.
- [Configurações e segurança](https://docs.befailproof.ai/pt-br/admin/settings-and-security.md): Configure valores operacionais e tome decisões conscientes sobre os dados do agente.

### Integrations and reference

#### Connect your agents

- [Integrações e referência](https://docs.befailproof.ai/pt-br/reference/overview.md): Conecte harnesses de agentes, SDKs, CLIs e a API HTTP compatíveis.
- [Harnesses de agentes](https://docs.befailproof.ai/pt-br/reference/harnesses.md): Capture sessões e aplique políticas em todos os 12 harnesses de agentes suportados.
- [Agentes personalizados](https://docs.befailproof.ai/pt-br/reference/custom-agents.md): Configuração, catálogo de eventos, regras de correlação e entrega para o failproofai-sdk.
- [Evaluator SDK](https://docs.befailproof.ai/pt-br/reference/evaluator-sdk.md): Execute seu próprio worker de avaliação, para juízes LLM e tudo mais que o Python hospedado não consegue fazer.
- [Políticas personalizadas](https://docs.befailproof.ai/pt-br/reference/policy-sdk.md): Crie, teste e implante políticas em JavaScript ou TypeScript para falhas específicas dos seus agentes.
- [Self-host Failproof AI Cloud](https://docs.befailproof.ai/pt-br/reference/self-hosting.md): Implante o plano de controle do Failproof AI em um cluster Kubernetes gerenciado pelo cliente.

#### Reference

- [Failproof AI CLI](https://docs.befailproof.ai/pt-br/reference/failproof-cli.md): Instale hooks, gerencie políticas locais, conecte ao Cloud e opere o daemon local.
- [Dashboard local](https://docs.befailproof.ai/pt-br/reference/local-dashboard.md): Revise projetos locais, sessões, atividade de políticas, configuração, auditorias e varreduras agendadas.
- [Configuração local](https://docs.befailproof.ai/pt-br/policies/local-configuration.md): Controle escopo de políticas, parâmetros, arquivos personalizados e configurações do Failproof AI a nível de máquina.
- [Failproof Cloud CLI](https://docs.befailproof.ai/pt-br/reference/cloud-cli.md): Referência completa para consultar e administrar o Failproof AI Cloud com fp.
- [HTTP API](https://docs.befailproof.ai/pt-br/reference/http-api.md): Autentique-se na API pública Failproof AI Cloud `/v1` e utilize a referência de endpoints gerada.
- [Eventos e configuração](https://docs.befailproof.ai/pt-br/reference/events-and-configuration.md): Referência ao modelo de eventos, ambientes, armazenamento local e limites de configuração.
- [Solução de Problemas](https://docs.befailproof.ai/pt-br/reference/troubleshooting.md): Diagnostique sessões ausentes, políticas ausentes, falhas de entrega e ações bloqueadas do agente.