# Failproof AI: Chinese

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

## Chinese

### Start

#### Start here

- [让你的智能体万无一失](https://docs.befailproof.ai/zh/index.md): 为智能体运行的每种环境提供可观测性与执行保障——编码 CLI、聊天网关、自托管助手以及你自己的自定义智能体。
- [快速开始](https://docs.befailproof.ai/zh/start/quickstart.md): 捕获一次 agent 会话，发现故障，并开始预防。
- [Agent harnesses](https://docs.befailproof.ai/zh/reference/harnesses.md): 捕获会话并在所有 12 个受支持的 agent harness 上执行策略。
- [Failproof Assistant](https://docs.befailproof.ai/zh/sessions/assistant.md): 用自然语言分析和操作 Failproof AI，涵盖问题查询、仪表板和审计等功能。
- [运行首次故障检查](https://docs.befailproof.ai/zh/start/first-audit.md): 通过 Cloud 控制台或 fp CLI 创建审计，并查看初始发现结果。
- [用策略预防第一次故障](https://docs.befailproof.ai/zh/start/first-policy.md): 编写一个策略版本，以观察模式部署，然后强制执行。
- [选择您的设置方式](https://docs.befailproof.ai/zh/start/setup.md): 选择本地强制执行、Failproof AI Cloud 或企业部署。
- [核心概念](https://docs.befailproof.ai/zh/start/concepts.md): Failproof AI 中使用的一组核心概念。

##### Starter templates

- [自定义 Agent](https://docs.befailproof.ai/zh/start/quickstarts/custom-agents.md): 用三个 `with` 块包裹你的 agent，它就会开始记录。
- [LangChain 和 LangGraph](https://docs.befailproof.ai/zh/start/quickstarts/langchain.md): 安装、插桩并查看您的第一条追踪记录。
- [CrewAI](https://docs.befailproof.ai/zh/start/quickstarts/crewai.md): 安装、接入并查看你的第一条追踪记录。
- [LlamaIndex](https://docs.befailproof.ai/zh/start/quickstarts/llamaindex.md): 安装、插桩，并查看您的第一条追踪记录。
- [Pydantic AI](https://docs.befailproof.ai/zh/start/quickstarts/pydantic-ai.md): 安装、插桩并查看你的第一条追踪记录。

### Trace Agents

#### Understand every run

- [会话](https://docs.befailproof.ai/zh/sessions/overview.md): 从一次智能体运行的完整记录开始。
- [实时事件](https://docs.befailproof.ai/zh/sessions/live-events.md): 在会话运行期间观察 Agent 活动的实时到达情况。
- [读取追踪记录](https://docs.befailproof.ai/zh/sessions/read-a-trace.md): 找到改变 agent 会话走向的事件。
- [模型](https://docs.befailproof.ai/zh/sessions/models.md): 比较模型延迟、Token 数量、上下文使用情况和流量分布。
- [Hooks](https://docs.befailproof.ai/zh/sessions/hooks.md): 分别衡量 hook 活动、触发器及延迟，与策略结果相互独立。
- [策略决策](https://docs.befailproof.ai/zh/sessions/policy-decisions.md): 查看已评估、阻止、指导或允许的策略。
- [工具](https://docs.befailproof.ai/zh/sessions/tools.md): 在代理会话中发现速度慢、失败或过度使用的工具。
- [错误](https://docs.befailproof.ai/zh/sessions/errors.md): 对重复出现的错误进行分组，并查看其背后的会话。
- [指标](https://docs.befailproof.ai/zh/sessions/metrics.md): 绘制延迟、成本和 Token 用量等量级指标。
- [仪表盘](https://docs.befailproof.ai/zh/sessions/dashboards.md): 追踪对 Agent 或工作流至关重要的可靠性信号。
- [查询](https://docs.befailproof.ai/zh/sessions/queries.md): 使用可复用的 SQL 探索会话、事件和评估数据。

#### Plug in your agent

- [为你的 Agent 接入监控](https://docs.befailproof.ai/zh/start/integrations.md): 只需一次调用，将任意受支持的 Agent 框架连接到 Failproof AI。
- [自定义 agents](https://docs.befailproof.ai/zh/start/integrations/custom-agents.md): 为自行编写的 agent 或没有适配器的框架添加埋点。
- [LangChain 和 LangGraph](https://docs.befailproof.ai/zh/start/integrations/langchain.md): 通过一次调用为图、节点、工具、检索器和模型调用添加追踪。
- [CrewAI](https://docs.befailproof.ai/zh/start/integrations/crewai.md): 对 crew、flow、agent（按角色）、工具、内存和人工反馈进行埋点追踪。
- [LlamaIndex](https://docs.befailproof.ai/zh/start/integrations/llamaindex.md): 对工作流、步骤、函数代理和检索器进行埋点。
- [Pydantic AI](https://docs.befailproof.ai/zh/start/integrations/pydantic-ai.md): 对类型化的 Agent、工具、模型调用和重试进行追踪。

### Find failures

#### Evaluate agents

- [评估 Agent](https://docs.befailproof.ai/zh/evaluations/overview.md): 使用您自定义的评估为每个已完成的会话打分：托管的 Python 检查，或在您自己的 Worker 中运行的 LLM 评判器。
- [编写评估](https://docs.befailproof.ai/zh/evaluations/write.md): 描述要衡量的内容，让助手起草一个托管的 Python 评估，或者自己编写代码。LLM 评判器在您自己的 worker 中运行。
- [测试评估](https://docs.befailproof.ai/zh/evaluations/test.md): 在部署前对真实会话运行评估。不存储任何数据。
- [部署和版本管理评估](https://docs.befailproof.ai/zh/evaluations/deploy.md): 部署不可变版本、查看当前线上内容、发布新版本、回滚，以及对已有会话进行评分。
- [读取评估结果](https://docs.befailproof.ai/zh/sessions/evaluations.md): 跨时间维度绘制评估分数图表、比较 Agent 和环境、查看会话低分原因，并向助手提问。

#### Find and manage failures

- [审计](https://docs.befailproof.ai/zh/audits/overview.md): 对特定会话集合进行审查，发现仅凭追踪记录无法揭示的故障。
- [审计本地 Agent 历史记录](https://docs.befailproof.ai/zh/audits/local-audit.md): 离线扫描受支持的 Agent CLI 历史记录，在本地审查高风险或低效行为。
- [设置审计](https://docs.befailproof.ai/zh/audits/setup.md): 定义审计目标、会话范围和证据上下文。
- [Agent 上下文](https://docs.befailproof.ai/zh/audits/agent-contracts.md): 告知审计每个 agent 的职责、产出及禁止行为。
- [运行并审查审计](https://docs.befailproof.ai/zh/audits/run.md): 运行审计，验证其覆盖范围，并检查生成的结果。
- [审计频率](https://docs.befailproof.ai/zh/audits/cadence.md): 选择定期审计的运行时间及其审查的数据范围。
- [发现与问题](https://docs.befailproof.ai/zh/audits/findings-and-issues.md): 将审计证据转化为有归属、可追踪的修复工作。
- [警报](https://docs.befailproof.ai/zh/audits/alerts.md): 检测复发情况并将事件路由到合适的响应人员。
- [审计方案](https://docs.befailproof.ai/zh/audits/recipes.md): 常见 Agent 故障排查的起始目标。

### Prevent failures

#### Prevent repeat failures

- [策略](https://docs.befailproof.ai/zh/policies/overview.md): 在已知故障重复发生之前，观察、引导或阻断 Agent 行为。

#### Get a policy

- [编写策略](https://docs.befailproof.ai/zh/policies/editor.md): 让 Failproof AI 根据审计发现起草策略，或自行编写源代码，然后审查、测试并发布。
- [使用策略包](https://docs.befailproof.ai/zh/policies/packs.md): 为您的用例接入 Failproof AI 策略包，或从策略中心获取社区包，并自定义其执行内容。

#### Ship a policy

- [测试策略](https://docs.befailproof.ai/zh/policies/test.md): 在任何机器执行之前，针对已有流量对草稿进行回测，验证它能阻止应阻止的内容，并放行应允许的内容。
- [部署策略](https://docs.befailproof.ai/zh/policies/deploy.md): 将经过测试的策略版本以观察模式部署到机器上，强制执行，并确认每台机器都已接收到该版本。
- [版本与回滚](https://docs.befailproof.ai/zh/policies/rollback.md): 每次发布都是不可变的版本，因此只需重新部署上一个良好版本，即可撤销影响有效 Agent 工作的发布。
- [发布策略包](https://docs.befailproof.ai/zh/policies/publish-a-pack.md): 将您自己的策略作为 GitHub 发布版本发布，供任何人安装。
- [失败行为](https://docs.befailproof.ai/zh/policies/failure-behavior.md): 了解策略评估或本地守护进程不可用时会发生什么。

### Admin

#### Operate Failproof AI

- [管理](https://docs.befailproof.ai/zh/admin/overview.md): 管理访问权限、使用情况、组织和安全性，而不会将其混入可靠性工作流。
- [使用情况](https://docs.befailproof.ai/zh/admin/usage.md): 查看组织的资源消耗及当前计费周期。
- [密钥与权限](https://docs.befailproof.ai/zh/admin/keys-and-permissions.md): 为机器、自动化任务和运营方创建限定范围的 API 密钥。
- [用户与组织](https://docs.befailproof.ai/zh/admin/users-and-organizations.md): 管理成员关系，并将每个组织的数据与操作限定在各自范围内。
- [设置与安全](https://docs.befailproof.ai/zh/admin/settings-and-security.md): 配置操作设置，并对 agent 数据做出明智的选择。

### Integrations and reference

#### Connect your agents

- [集成与参考](https://docs.befailproof.ai/zh/reference/overview.md): 连接支持的 Agent 运行框架、SDK、CLI 及 HTTP API。
- [Agent harnesses](https://docs.befailproof.ai/zh/reference/harnesses.md): 捕获会话并在所有 12 个受支持的 agent harness 上执行策略。
- [自定义 Agent](https://docs.befailproof.ai/zh/reference/custom-agents.md): failproofai-sdk 的配置、事件目录、关联规则及数据投递说明。
- [Evaluator SDK](https://docs.befailproof.ai/zh/reference/evaluator-sdk.md): 在您自己的基础设施上运行评估 Worker，用于 LLM 裁判以及托管 Python 无法完成的一切任务。
- [自定义策略](https://docs.befailproof.ai/zh/reference/policy-sdk.md): 为你的 Agent 中特定的故障场景编写、测试并部署 JavaScript 或 TypeScript 策略。
- [自托管 Failproof AI Cloud](https://docs.befailproof.ai/zh/reference/self-hosting.md): 在客户自管的 Kubernetes 集群上部署 Failproof AI 控制平面。

#### Reference

- [Failproof AI CLI](https://docs.befailproof.ai/zh/reference/failproof-cli.md): 安装 hooks、管理本地策略、连接 Cloud 并操作本地守护进程。
- [本地仪表板](https://docs.befailproof.ai/zh/reference/local-dashboard.md): 查看本地项目、会话、策略活动、配置、审计及计划扫描。
- [本地配置](https://docs.befailproof.ai/zh/policies/local-configuration.md): 管理策略作用域、参数、自定义文件以及机器级 Failproof AI 设置。
- [Failproof Cloud CLI](https://docs.befailproof.ai/zh/reference/cloud-cli.md): 使用 fp 查询和管理 Failproof AI Cloud 的完整参考指南。
- [HTTP API](https://docs.befailproof.ai/zh/reference/http-api.md): 向 Failproof AI Cloud 公共 `/v1` API 进行身份验证，并使用生成的端点参考文档。
- [事件与配置](https://docs.befailproof.ai/zh/reference/events-and-configuration.md): 参考事件模型、环境、本地存储和配置边界。
- [故障排查](https://docs.befailproof.ai/zh/reference/troubleshooting.md): 诊断会话缺失、策略缺失、事件投递失败以及 Agent 操作被阻止等问题。