SuperAPI AI 工具集

agently

智能体与模型

查看项目

更新于 10-15 19:51

技能介绍

Agently 用于当需求以产品行为而非具体 API 形式提出时,先选择最小的原生归属,再决定文件与机制。请求无需提及 Agently。

用途与流程:把请求归约为目标、输入、输出、副作用、证据与生命周期需求;区分模型负责的语义决策与宿主负责的校验、授权、身份关联、算术和副作用;为每个决策、状态和副作用指定唯一归属;对非平凡流程绘制节点、值/事件边、不变量及各字段与阶段的生产需求;在调用方拥有异步边界时采用 async-first,并将确定性契约校验与模型质量校验分开;若没有原生归属能承载必需不变量,应报告框架缺口,而非用业务胶水或透传门面掩盖。

按归属路由:provider 设置、prompt、结构化输出、LongContent、auto_continue、TTS/STT 音频、结果复用、会话记忆、embeddings、检索走 agently-request;AgentExecution 插件、final policies、Actions、Shell、MCP、ExecutionResource、TaskWorkspace、RecordStore、服务暴露、RuntimeEvent、DevTools 走 agently-runtime;进程内任务生命周期、同步/异步桥接、循环中立句柄、结算、重放通道、本地监听走 agently-stage;跨归属架构、请求/值/事件拓扑、证据与身份边界、生命周期、压力、信息丢失审计走 agently-design;开发者自有的推进、分支、并发、审批、等待/恢复、重试、重启安全编排走 agently-triggerflow;从 LangChain、LangGraph、LlamaIndex、CrewAI 等迁移走 agently-migration。显式模型生成或应用提交的无环 DAG 数据属低频高级场景,保留在此并读 references/task-dag.md,普通 Agent 或工作流不要引入 TaskDAG。

核心归属规则:ModelRequest 负责一次模型交互及其 prompt/输出契约;AgentExecution 负责一次 Agent 运行及其生产者、控制、结果与流,4.1.4.8 中 request、plan、long_content、long_task 为插件;agent.create_task(...) 返回长任务 AgentExecution 草稿,其生产者负责规划、证据与重规划;AudioModelRequest 负责独立 TTS/STT 驱动,Agent 音频调用与依赖音频的执行插件需显式音频绑定;ActionRuntime 负责模型可调用操作,ExecutionResource 负责实时依赖生命周期;TriggerFlow 负责应用可见编排与运行时信号;TaskContext 负责任务信息并创建消费者绑定读取器,TaskWorkspace 负责文件,RecordStore 负责持久记录与恢复,SkillLibrary 负责不可变已安装 Skill 修订。Agently.skills_executor 仅作管理与上下文兼容,不要重建已移除的通用 Workspace、ContextBuilder、SkillsManager、Skills 路由/策略、skill_activation 或 workspace_operation 归属。

ModelRequest 边界:运行时事实放 .input(...),权威 schema、签名与源事实放 .info(...),转换与调用规则放 .instruct(...),确切消费形态放 .output(...);为每个消费字段声明类型、语义、必需性、枚举/格式/范围、可空性与跨字段约束;结构化 ModelRequest 负责散文推导的意图、路由、规划、相关性或质量判断,宿主代码校验有界枚举/键并执行副作用;不要请求隐藏思维链,有界过程字段仅在具备命名角色、边界、消费者、保留规则与失败行为时才合理。

项目与验证门:单请求应用从组合、设置、prompt 契约与测试开始,仅为当前归属与消费者添加工作流、服务、Actions、本地 Skills、工具或资源;逻辑节点不自动等于文件或类。确定性测试证明 schema、身份、生命周期、核算、文件或记录副作用与安全;语义质量需声明标准与结构化编码代理、模型或人工评审;关键性(硬门或软目标)与评估方法(确定性或语义)分开分类。真实模型主张先定义标准,诚实标注模拟,使用最小授权代表性运行,原始事实与判断分开记录,真实轨迹覆盖模拟预期。

反模式:未检查原生归属就自建解析器、重试管理器、状态存储或调度器;用关键词、子串、正则、分词或手写评分表作为语义归属;未消费的输出字段、请求阶段、包装器或项目目录;未做依赖分析的全串行复杂流程;把完整源码、身份密集记录或原始元数据复制进每个 prompt;把预设答案、隐藏期望答案夹具或仅测试用生产分支当作框架能力证据。

限制:资料未提供具体安装命令、价格、平台支持与效果数据。