2.7 KiB
2.7 KiB
description, kind
| description | kind |
|---|---|
| 具有作用域工具和有界批次执行的原生函数调用。 | package-reference |
@deepseek-ai/dsh-tool-executor-native
English | 中文
概述
当模型应直接调用每个可见工具时，使用此执行器。在部署、预设或 Agent 作用域中，将它与工具注册表一同挂载。并行安全调用可以重叠，独占调用构成屏障，结果保留模型顺序。
目录
使用本包
将此行加入已经挂载 dsh-tools 的组合。最近作用域的执行器决定工具行为；同一作用域只允许一个执行器。
- name: '@deepseek-ai/dsh-tool-executor-native'
Agent 步骤使用 agent-loop 并发配置，循环在每个批次开始时读取一次上限。本插件没有配置字段。直接构造 NativeToolExecutor 的调用方可以传入回调，默认返回 10；批次未指定 maxParallelToolCalls 时，每个工具组读取该回调。上限必须是正整数；1 表示串行执行。
理解实现
实现细节——点击展开
执行器接收完整的原始调用批次，负责解析、调度、取消和可选的模型步骤日志。它复用共享调用流水线来执行策略、工具和结果通知。中止后，它等待已开始的工作完成，并为跳过的调用返回有序错误结果。
src/index.ts— 作用域执行器注册；工具描述和批次执行。
进一步探索
模型体验
可见工具
模型看到什么
每个可见工具的 name、description 和 JSON Schema 参数；不会增加提示词章节。
Token 影响
请求成本与可见定义成正比；隐藏定义会移除对应 schema 成本。
KV Cache 影响
只要工具描述和顺序不变，前缀就保持稳定。
已知限制与延期工作
以下约束适用于已开始的调用。
- 同进程工具必须遵守取消信号；执行器无法强制终止忽略信号的工具。
开发备注
维护者的工作上下文——点击展开
无。