# IaGenify SDK 0.3.2 为智能体提供可用工具地图。

Canonical URL: https://www.iagenify.com/zh/news/iagenify-sdk-agent-capability-catalogue

智能体说明现在依据本次运行实际启用的工具和操作，帮助它选择真实可用的能力，而不是从泛化文档中猜测。

## Key points
- 智能体会收到本次运行可用能力的精简清单。
- 清单反映应用选择、权限模式和运行环境实际启用的工具。
- 契约检查会对照 SDK 方法与智能体工具覆盖情况，或核对有理由的排除项。

智能体只有知道有哪些操作可用，才能作出合适选择。通用文档列表并不足够：应用可能只启用一部分功能，运行环境可能缺少某项能力，权限模式也可能禁止某个操作。IaGenify SDK 0.3.2 增加了基于本次运行实际工具的能力地图。

## 描述实际运行，而非理论平台

运行开始时，智能体会收到当前启用的工具组及操作摘要。如果应用移除某项工具，它就会从地图中消失。如果运行环境不支持某个操作，智能体也不会收到可以执行它的错误暗示。因此，计划更贴近真正可执行的范围。

## 同一目录支持多种判断

这份目录既帮助智能体选择操作、找到对应的详细文档，也帮助开发者了解能力所在的位置。摘要回答“有什么”，详细参考回答“如何使用”。分层设计让初始地图保持精简，并使后续说明更有针对性。

## 覆盖情况可以检查，而不只靠记忆

契约检查将 SDK 资源公开的方法与智能体工具实现进行对照。每个方法都必须由工具覆盖，或有记录在案的排除理由。这样，能力缺口会在开发时显现，而不必依赖人工同步多份列表。

这项检查也能防止意外扩大访问范围。涉及账户权限或秘密的方法可以有意排除，另一些操作则受运行环境限制。目录会区分这些有意边界与无意遗漏。

## 精简地图也能表达完整 SDK

版本按操作数量衡量智能体能力，而不只数顶层工具名称。一个工具可能包含多种操作，只数名称会掩盖实际能力。精简摘要可提供必要上下文，无需先进行冗长的能力发现调用。

> 智能体应根据本次运行确实拥有的能力制定计划，而不是根据平台或许支持的功能宣传册。

IaGenify SDK 0.3.2 让 SDK 与智能体循环之间的边界更易维护：能力来自运行时目录，契约检查则持续核对公开资源与工具是否一致。

## FAQ
### 能力地图会启用所有 SDK 方法吗？
不会。它描述本次运行可用的能力；应用选择、运行环境和权限仍然有效。

### 能力地图与文档有什么区别？
地图总结本次运行能做什么；详细文档解释如何使用受支持的操作。

### 为什么统计操作而不是工具名称？
一个工具可能包含多种操作，因此操作数量更能说明智能体实际能做什么。

### 敏感操作会自动开放吗？
不会。涉及账户权限或秘密的方法可以有记录并受检查地排除在外。