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

# Integrações e referência

> Conecte harnesses de agentes, SDKs, CLIs e a API HTTP compatíveis.

Escolha a integração mais próxima de onde seu agente já está sendo executado.

<Columns cols={2}>
  <Card title="Harnesses de agentes" icon="plug-zap" href="/pt-br/reference/harnesses">
    Instale hooks para CLIs de agentes autônomos e de codificação compatíveis.
  </Card>

  <Card title="Agentes personalizados" icon="python" href="/pt-br/reference/python-sdk">
    Instrumente traces para encontrar falhas em agentes personalizados e entre em contato conosco para adicionar prevenção ao seu runtime.
  </Card>

  <Card title="Dashboard local" icon="monitor-cog" href="/pt-br/reference/local-dashboard">
    Revise projetos locais, sessões, atividade de políticas e auditorias offline.
  </Card>

  <Card title="Failproof AI CLI" icon="terminal" href="/pt-br/reference/failproof-cli">
    Configure captura local, hooks, políticas, auditorias, entrega e estado da máquina.
  </Card>

  <Card title="Failproof Cloud CLI" icon="cloud-cog" href="/pt-br/reference/cloud-cli#cli-commands">
    Consulte e administre sessões, auditorias, problemas, alertas, chaves, usuários e configurações do Cloud.
  </Card>

  <Card title="SDK do avaliador" icon="gauge" href="/pt-br/reference/evaluator-sdk">
    Pontue sessões completas ou inativas com um serviço FastAPI.
  </Card>

  <Card title="Políticas personalizadas" icon="shield-plus" href="/pt-br/reference/policy-sdk">
    Crie e teste decisões de allow, instruct e deny específicas para seu fluxo de trabalho.
  </Card>

  <Card title="Self-hosting" icon="cloud-cog" href="/pt-br/reference/self-hosting">
    Implante o plano de controle do Cloud em um cluster Kubernetes gerenciado pelo cliente.
  </Card>
</Columns>

A [referência da API HTTP](/pt-br/reference/http-api) gerada cobre a superfície pública `/v1`. Páginas escritas manualmente explicam fluxos de trabalho que abrangem múltiplos endpoints ou utilizam interfaces administrativas fora dessa superfície pública.

## Conectar um agente e verificar dados

<Tabs>
  <Tab title="Dashboard">
    1. Abra **Administração → Chaves**, crie uma chave com `events:add` e `policies:pull`, e copie o segredo.
    2. Configure a integração usando a página correspondente acima.
    3. Abra **Observar → Eventos** para confirmar que os eventos chegam, depois **Observar → Sessões** para confirmar que eles formam execuções completas.
    4. Filtre pelo ambiente da integração e inspecione uma sessão para verificar os campos de modelo, ferramenta, erro e política necessários pelas auditorias.

    Comece pelo painel de chaves. As permissões selecionadas determinam se a máquina pode enviar eventos e receber políticas gerenciadas pelo Cloud.

    <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=a428bdae79f837471acb66414ff6455b" alt="O painel de nova chave de API usado para conceder permissões de ingestão de eventos e entrega de políticas." width="2940" height="1604" data-path="images/dashboard/key-create.png" />

    Após conectar a integração, use a lista de Sessões para confirmar que os eventos estão sendo agrupados em execuções completas no ambiente esperado.

    <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/sessions-list.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=f1fb545746143e87b8b5daedabfc5559" alt="A lista de Sessões usada para verificar que uma integração recém-conectada está reportando execuções completas do agente." width="3200" height="2000" data-path="images/dashboard/sessions-list.png" />

    Abra uma dessas sessões antes de considerar a integração concluída; o trace deve conter o modelo, a ferramenta, o erro e as evidências de política necessárias para suas auditorias.
  </Tab>

  <Tab title="CLI">
    Crie uma chave de máquina, conecte o daemon do Failproof e verifique a primeira sessão.

    ```bash theme={null}
    fp keys create agent-production \
      --add events:add \
      --add policies:pull

    failproofai config \
      --connect https://app.befailproof.ai \
      --token <machine-key>

    failproofai flush --wait
    fp sessions --since 1h --env production
    fp events --since 1h --env production --limit 20
    ```

    Use `fp --json sessions ...` quando outro utilitário consumir o resultado. Flags globais como `--json`, `--org` e `--base-url` devem vir antes do comando.

    Consulte a [referência do Failproof AI CLI](/pt-br/reference/failproof-cli) para comandos locais e a [referência do Failproof Cloud CLI](/pt-br/reference/cloud-cli#cli-commands) para comandos `fp`.
  </Tab>
</Tabs>
