智能体只有知道有哪些操作可用,才能作出合适选择。通用文档列表并不足够:应用可能只启用一部分功能,运行环境可能缺少某项能力,权限模式也可能禁止某个操作。IaGenify SDK 0.3.2 增加了基于本次运行实际工具的能力地图。
描述实际运行,而非理论平台
运行开始时,智能体会收到当前启用的工具组及操作摘要。如果应用移除某项工具,它就会从地图中消失。如果运行环境不支持某个操作,智能体也不会收到可以执行它的错误暗示。因此,计划更贴近真正可执行的范围。
同一目录支持多种判断
这份目录既帮助智能体选择操作、找到对应的详细文档,也帮助开发者了解能力所在的位置。摘要回答“有什么”,详细参考回答“如何使用”。分层设计让初始地图保持精简,并使后续说明更有针对性。
覆盖情况可以检查,而不只靠记忆
契约检查将 SDK 资源公开的方法与智能体工具实现进行对照。每个方法都必须由工具覆盖,或有记录在案的排除理由。这样,能力缺口会在开发时显现,而不必依赖人工同步多份列表。
这项检查也能防止意外扩大访问范围。涉及账户权限或秘密的方法可以有意排除,另一些操作则受运行环境限制。目录会区分这些有意边界与无意遗漏。
精简地图也能表达完整 SDK
版本按操作数量衡量智能体能力,而不只数顶层工具名称。一个工具可能包含多种操作,只数名称会掩盖实际能力。精简摘要可提供必要上下文,无需先进行冗长的能力发现调用。
智能体应根据本次运行确实拥有的能力制定计划,而不是根据平台或许支持的功能宣传册。
IaGenify SDK 0.3.2 让 SDK 与智能体循环之间的边界更易维护:能力来自运行时目录,契约检查则持续核对公开资源与工具是否一致。
常见问题
能力地图会启用所有 SDK 方法吗?
不会。它描述本次运行可用的能力;应用选择、运行环境和权限仍然有效。
能力地图与文档有什么区别?
地图总结本次运行能做什么;详细文档解释如何使用受支持的操作。
为什么统计操作而不是工具名称?
一个工具可能包含多种操作,因此操作数量更能说明智能体实际能做什么。
敏感操作会自动开放吗?
不会。涉及账户权限或秘密的方法可以有记录并受检查地排除在外。