Agently Request 是 Agently 技能体系中负责请求侧（request-side）设置与契约的技能。当一项工作可以由单个 ModelRequest 家族承担时使用它；若后续语义步骤需要工具结果、系统查询、审批、产物回读或宿主计算，或分支、并发、重试、暂停/恢复必须体现在应用生命周期中，则应改用 agently-triggerflow。
主要能力与用法：按需查阅参考文档，包括模型能力（独立模型角色、图像模式/直接输出、音频任务输入）、音频（独立 TTS/STT、Agent 音频绑定、连续音频字节、输出块，AudioModelRequest 是独立插件能力而非文本 Prompt 管线）、模型设置（提供方、端点、环境、设置命名空间、连通性）、Prompt 管理（请求职责、效果调优、输入输出充分性或冗余、协作评审、Prompt 配置/引用、可复用契约与继承）、输出控制（结构化输出、Pydantic、ensure/校验、流式格式、长输出直投）、结果复用（文本/数据/元数据或消费流）、会话记忆、知识库（嵌入、重排模型、RecordStore、ContextSource、检索与带引用回答）、上下文与技能。
请求契约方面：把运行时事实放入 input，权威证据/API/schema 材料放入 info，行为与转换规则放入 instruct，下游实际消费的形状放入 output；为每个被消费字段定义类型、含义、必填性、枚举/格式/范围、可空性与跨字段约束。在首次尝试前给出所有非敏感且可满足的校验规则，确定性校验仍具权威性。一次性流畅请求应保持为一条链：.input(...)、.info(...)、.instruct(...)、.output(...) 再调用结果；仅在真正复用、独立配置或动态组合时拆分。VLM 请求优先使用 .image(question=..., file=...|url=...|files=[...]|urls=[...])，仅在调用方自行管理提供方风格混合内容或精确顺序时用 .attachment(...)。
结果与记忆：直接 ModelRequest 调用返回 ModelRequestResult，Agent 快速链返回 AgentExecutionResult，应复用同一结果门面获取文本、解析数据、元数据与流。会话记忆不是工作流状态：SessionMemory 负责抽取与压缩策略，RecordStore 负责持久记录与检索，TriggerFlow 执行状态负责工作流推进。检索回答应提供可信 ref_id，要求 [[ref:<ref_id>]]，并在宿主侧解析来源卡片/链接。
限制与避免事项：不要在检查 Agently 设置与输出契约前手写提供方 HTTP、Prompt 模板、JSON 修复或重试循环；不要为缩短可见代码而把一次性 schema 或 Prompt 步骤移出请求链；不要为文本、数据和元数据分别重复请求模型；不要把检索命中、记忆记录、临时流字段或模型文本当作授权或副作用的确定性证据；不要把单次观察到的字面量或行为提升为规范性 Prompt 指令。资料未提供具体收费、价格与平台支持信息。