mcpField
U
utility

utility

github.com/atholaAgent 工作流34379 次安装1 天前更新
代码仓库

关于 utility

utility 是用于 Agent 编排的决策框架,以预期收益减去加权成本为候选动作评分。它帮助决定是否检索信息、调用工具、验证、委派或停止,并规定终止条件与记录方式。

主要功能

  1. 01为六类编排动作评分
  2. 02计入成本、不确定性和冗余
  3. 03应用步骤预算与停止阈值
  4. 04记录评分和决策

适用场景

  1. 01限制高成本工具调用
  2. 02决定是否委派子任务
  3. 03判断部分结果是否需要后续处理
  4. 04检查输出是否需要验证

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/athola/claude-night-market --skill utility

安装后在 Claude Code 中输入/utility确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

modules/
action-selector.md
gain.md
integration.md
redundancy.md
state-builder.md
step-cost.md
uncertainty.md

详细介绍

Utility Skill

概述

一种基于 Liu 等人的论文《Utility-Guided Agent Orchestration for Efficient LLM Tool Use》(arXiv:2603.19896)的 Agent 编排决策框架。 该框架通过从预期收益中减去加权成本,为每个候选操作评分,并得出一个用于指导操作选择的效用值。 该框架会让过度调用工具和过早停止这两种错误都付出代价,从而避免它们。 效用范围为 [-2.3, 1.0]。

适用场景

  • 决定是否再调度一个 Agent,或再调用一次工具
  • 对成本高昂的工具调用(搜索、代码执行、委派)进行门控
  • 为子任务选择合适的模型层级
  • 收到部分结果后决定是否继续
  • 在写入或提交输出前进行验证门控

不适用场景

  • 只有一个明显操作的单步任务
  • 评分成本超过收益的简单任务
  • 已执行且无法撤销的操作

操作空间

A = {respond, retrieve, tool_call, verify, delegate, stop}

操作描述
respond根据当前上下文输出最终答案
retrieve获取其他信息(搜索、读取、查询)
tool_call执行工具(代码运行器、API、文件写入)
verify检查先前结果的正确性或完整性
delegate启动子 Agent 或移交给专业人员
stop终止循环并返回当前状态

效用函数

U(a | s_t) = Gain(a | s_t)
           - λ₁ · StepCost(a | s_t)
           - λ₂ · Uncertainty(a | s_t)
           - λ₃ · Redundancy(a | s_t)
参数默认值理由
λ₁1.0成本基准;其他权重均以此为参照
λ₂0.5与结果的经验相关性较弱(r=0.0131)
λ₃0.8冗余剪枝可节省约 10% 的 token

效用范围:[-2.3, 1.0]。 正值表示值得采取该操作。 低于下限值(默认值为 -0.5)的分数表示应跳过该操作。

终止条件

满足以下任一条件时,停止循环:

  • (a) 选中的操作为 stop
  • (b) 步数预算耗尽(默认值:10 步)
  • (c) 所有非 stop 操作的分数都低于下限值(默认值:-0.5)

**高收益覆盖规则:**如果任一操作的 Gain >= 0.7,可覆盖条件 (c)。 在推理轨迹中记录覆盖规则及收益值。

快速入门

最精简的 4 步建议模式:

  1. 构建状态:按照 modules/state-builder.md,收集任务上下文
  2. 为候选操作评分:按照 modules/action-selector.md,评估 A 中的每个操作
  3. 优先选择效用最高者:在满足终止条件的前提下,选择 U(a | s_t) 最大的操作
  4. 记录分数和决策:执行前记录胜出操作、 其效用值和步数

详细资源

  • 状态构建器:modules/state-builder.md,说明如何根据任务上下文填充 s_t
  • 收益:modules/gain.md,说明如何估算预期信息 或进展收益
  • 步骤成本:modules/step-cost.md,token、延迟和 金钱成本表
  • 不确定性:modules/uncertainty.md,置信度 估算与校准
  • 冗余:modules/redundancy.md,检测重复 或增量较低的操作
  • 操作选择器:modules/action-selector.md,评分 循环和打破平局规则
  • 集成:modules/integration.md,将效用 评分接入现有编排循环

退出标准

  • 已构建包含任务目标和先前步骤的状态
  • 选择操作前已为全部六种操作评分
  • 每步之后均已检查终止条件
  • 每个已执行步骤均已记录分数和决策
  • 已记录高收益覆盖规则及收益值

评论

支持 Markdown