工具与技能Tools & skills

心智模型Mental model

Toolkit 是工具注册表与执行器：它把函数/注解方法转成 schema，交给模型选择，并在执行侧完成参数校验、并发与结果封装。Toolkit is both registry and executor: it turns functions or annotated methods into schemas, lets the model choose, then validates arguments, runs concurrently and wraps results.

先学什么What to learn first

• 工具描述和参数 schema 就是提示词，名称与 description 决定模型是否会调用。Tool descriptions and parameter schemas are prompts; names and descriptions drive selection.
• 工具内部要幂等、可超时、返回结构化错误，而不是抛裸异常。Tools should be idempotent, timeout-aware and return structured errors instead of raw exceptions.
• 工具组（ToolGroup）用于按业务域批量启停和做权限收口。Tool groups enable per-domain activation and permission scoping.

生产常见坑Production pitfalls

• 工具返回超大文本，撑爆上下文并拖慢后续推理。Huge tool outputs blow up context and slow later reasoning.
• 在工具中直接做长事务，失败后无法重试。Long transactions inside tools cannot be retried safely.

进入对应闯关单元Practice this domain →