> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# AI 产品与平台文档

这个目录收录 retaintive 产品内 AI 能力的设计文档。它和 [AI Factory](/ai/factory/agentic-software-factory.md) 的边界不同：这里关注客户产品里的 AI 判断、traceability、eval、Task 和 tool calling；Factory 文档关注 AI 如何帮助团队开发和运营代码库。

## 推荐阅读顺序

Task / AI runtime 先从现行产品 contract 读起，再读通用平台分层：

1. [Task System Design V3](/product-design/v3/tasks-feature/task-domain-lifecycle.md) — **Task 与 AI runtime 的唯一 canonical 入口**：Task / Next Action / Activity / Outcome、Task Policy、authority、bounded reasoning loop、API 和 migration。
2. [LLM Application Foundation Concepts](/ai/product/2026-06-23-llm-application-foundation-concepts.zh.md) — 一条 LLM 请求从 context retrieval、request builder、schema/tool contract、writer 到 ledger/eval 的通用链路；其中旧 Task identifiers 只按 legacy snapshot 阅读。
3. [retaintive LLM 平台架构终态与 Traceability](/ai/product/2026-06-24-llm-platform-architecture-and-traceability.zh.md) — Governance / Data / Cross-cutting 三平面的通用职责；具体 Task product state 服从 V3。
4. [retaintive LLM 平台架构图解](/ai/product/2026-06-25-llm-platform-architecture-diagrams.zh.md) — 上一篇的图解版；图中的 Objective Config 不代表新增 Task 上层实体。
5. [LLM Output Contract 与 Prompt 管理方式](/ai/product/2026-06-23-llm-output-contract-architecture.zh.md) — **Current legacy contract snapshot**；typed metadata 方法仍可参考，`typeCategory / closeResult / taskDecisions[]` 不是 Target vocabulary。

Objective-first 材料只保留为历史 exploration，不是现行目标态：

- [AI Objective / Evidence 数据模型历史探索](/system-design/ai-objective-evidence-data-model-final-state.md) — 独立 Objective/Case 层未被 Task domain 采用。
- [Retaintive AI Operating System Objective-first 历史蓝图](/ai/product/2026-06-25-retaintive-ai-operating-system-roadmap.zh.md) — registry、ledger、tool boundary 可参考；Objective-first product model 已 superseded。

## 当前执行面

这些文档更贴近日常实现和 demo 前质量保障：

- [Ask AI：官方 Agent 能力、账户与受控业务操作](/ai/product/ask-ai-platform.md) — **2026-10-03 test feature snapshot**：完整目标、历史设计原型与真实截图、Agents SDK / Codex 分工、付款边界、改期确认和后续条件；产品文档见 PR #513；Ask AI 功能尚未合并到 infra main，未进入 production。
- [AI Agent Foundation 历史盘点](/ai/product/ai-agent-foundation-final-state.md) — superseded snapshot；实施前回到 V3 与 live code。
- [AI 集成路线图](/ai/product/ai-integration-roadmap.md) — 产品内 AI chat / dashboard insights / campaign / tool-calling 的集成机会和优先级。
- [Task Accuracy](/ai/product/task-accuracy.md) — Current legacy `taskDecisions[]` 的 scenario、golden eval、DB replay 和 revenue rehearsal；不能直接充当 V3 acceptance contract。
- [Call Accuracy](/ai/product/call-accuracy.md) — 单次 call transcript / call analysis 是否被正确理解。
- [Contact Accuracy](/ai/product/contact-accuracy.md) — 多次互动后的 contact context / lifecycle / safety state 是否正确。

## 放置规则

- 产品里的 AI 能力、LLM app 架构、prompt/output contract、eval 和 agent roadmap 放在 `docs/ai/product/`。
- 具体数据模型、schema 设计、write path、traceability 表结构放在 `docs/system-design/`。
- AI 帮团队写代码、跑 repo、操作 Lark/GitHub 的 factory / tooling 文档放在 `docs/ai/factory/` 或 `docs/tooling/`。