agently-model-request-playbook

用途：这是 Agently 中面向“模型请求侧”工作的场景路由入口。当需求从业务角度出发、而非针对某个具体 API 时使用它，帮助选择合适的请求技能或技能组合；它不代替具体实现技能。前置条件：Agently >= 4.0.8.5。\n\n适用范围：判断标准 Agently 模型请求应如何构建；判断高质量请求如何针对结构化、流式或复用进行升级；判断哪些部分属于 Agently、哪些属于业务逻辑；判断何时加入工具、MCP、知识库或 RAG 检索、会话连续性、提示词配置或 FastAPI 暴露；判断问题何时已超出单个请求范围、需要升级到 TriggerFlow。不适用于：直接的 API 级实现细节、特定提供方的配置细节、独立 TriggerFlow 工作流设计。\n\n用法：从 references/standard-request-path.md 开始处理仍像普通模型请求的需求；当请求需要更可靠、结构化、可流式或可复用时阅读 references/high-quality-request-path.md；当真正问题是归属与升级时阅读 references/ownership-and-escalation.md；当需求从抽取、工具使用、检索增强回答或服务暴露等业务场景出发时阅读 references/common-business-patterns.md；用 references/current-skill-map.md 选择实现技能或组合，然后切到所选实现技能中进行实际编码。\n\n路由规则：提供方设置、认证、代理、请求选项或最小验证 -> agently-model-setup；提示词槽位、请求与智能体提示状态、映射、附件或底层聊天历史组装 -> agently-input-composition；输出模式、结构化流式、响应复用或响应消费 -> agently-output-control；仅嵌入、离线索引或在线查询嵌入 -> agently-embeddings；本地工具、内置工具、工具循环或工具日志 -> agently-tools；MCP 服务器工具或 MCP 传输注册 -> agently-mcp；Chroma 支撑的知识库、检索或检索到回答 -> agently-knowledge-base-and-rag；会话支撑的连续性或重启后记忆恢复 -> agently-session-memo；提示词模板作为 YAML 或 JSON 配置 -> agently-prompt-config-files；FastAPIHelper 端点暴露 -> agently-fastapi-helper；多专用智能体、审阅者-撰写者、规划者-工作者或并行专家 -> agently-multi-agent-patterns；需求已超出单个请求、需要多步异步工作流控制 -> agently-triggerflow-playbook。\n\n核心原则：单请求优先，先用一个高质量请求解决问题再升级到工作流编排；异步优先，若运行时可使用异步 API，优先采用异步请求与响应处理；显式升级，仅当业务需求明确需要时才加入工具、检索、记忆、服务暴露或 TriggerFlow。\n\n限制：资料未提供收费、价格、平台支持范围、具体效果或完整使用步骤，均暂未提供。文中列出的 references 文件路径为原样保留。