product-surface-areas

用途：这是一份面向客户（customer-facing）的“表面区域”清单，即客户可直接使用、交互或依赖的一切对象，用于从概念上理解一次变更对整个产品可能意味着什么，即端到端的功能依赖树/传播链。示例场景为在撰写 PRD 时评估影响面。配套技能：了解受影响人群及变更如何按受众传播时加载 audience-impact；了解内部/基础设施表面时加载 internal-surface-areas。\n\n主要能力：按类别汇总共 63 项。API 与面向客户的数据契约 13 项，包括管理 API（/manage/... REST）、Run API（OpenAI 兼容的 POST /run/v1/chat/completions，SSE 流式）、Chat API（Vercel AI SDK 数据流，POST /run/api/chat）、A2A 协议（/agents/a2a）、Agent 发现（GET /.well-known/agent.json）、MCP 协议、Webhook 格式、OAuth 路由、OpenAPI 文档、OpenTelemetry Schema、inkeep.config.ts 格式、环境变量、共享类型。SDK 与库 2 项（@inkeep/agents-sdk、@inkeep/ai-sdk-provider）；CLI 2 项（inkeep/agents-cli，含 init、push、pull、add、dev、login；@inkeep/create-agents）；MCP 服务器与端点 7 项；管理 UI（可视化构建器与仪表盘）16 项；聊天体验 3 项；可观测性 UI 5 项；评估 UI 6 项；模板与脚手架 2 项；部署接口 3 项；文档与内容 4 项。\n\n关键用法：清单给出每个表面区域的描述、依赖项与源码路径，并附破坏性变更影响矩阵。例如管理 API 变更会波及 Webhook、OAuth、OpenAPI 文档、TypeScript SDK、CLI、统一 MCP Server 及大量管理 UI 页面；Chat API 变更影响 Vercel AI SDK Provider、Chat Widget、Playground 与 Copilot。还注明非面向客户项（数据库 Schema、运行时引擎、/api/auth/*、@inkeep/agents-work-apps 包）不作为客户契约。\n\n限制：本文仅为清单与依赖梳理，未提供具体安装命令、收费或使用步骤；命令示例等未在资料中给出。