#自定义工具

Liyan Labs 提供两种工具扩展方式：内置工具是随服务发布的一方 Go 代码；用户和第三方集成通过 MCP 提供，并在明确选择的 Desktop 或 Runner 上执行。

#选择扩展方式

#内置工具

内置工具属于仓库代码变更，不是运行时加载的用户脚本。一个完整的内置工具贡献需要同时更新以下 Go 入口：

• service/pkg/core/tools/：稳定工具 ID、展示元数据、描述、分类与上下文要求
• service/pkg/worker/chatdriver/toolprep/：JSON Schema、可用性门控、执行器与错误处理
• service/pkg/core/toolstrategy/：需要配置时所属的功能与运行配置
• 目录暴露、准备、执行和授权的聚焦测试

元数据 ID、模型可见的 Schema 名称和执行器映射键必须完全一致。工具准备层是权威边界：显式空选择不会暴露工具；依赖不可用时必须失败关闭；每个暴露给模型的工具都必须有对应执行器。

#MCP 工具

不应进入 Liyan Labs 服务源码的自定义集成应使用 MCP。在 Liyan Labs 中添加 MCP 提供方、授予所需权限，并为智能体选择它。提供方声明工具名称、描述与输入 Schema；Liyan Labs 只会物化当前用户和会话已获授权的工具。

MCP 执行遵循本地优先边界。提供方进程、业务凭据、工具调用及其访问的文件都保留在明确选择的 Desktop 或 Runner 上。若该设备或其已验证运行时不可用，工具即不可用；Liyan Labs 不会把调用迁移到其他设备或托管后备服务。

连接与测试步骤请参阅 MCP 服务器 文档。