插件配置与工具调用

核心认识

插件把外部 API 暴露为模型可选择的工具。工具描述要足够明确，参数必须校验，鉴权与业务参数分离，返回结果要限制大小并处理外部错误。

• 一个工具完成一个动作，名称使用清晰动词。
• Schema 标出必填、类型、枚举和长度限制。
• 鉴权信息由平台注入，不让模型生成。
• 写操作使用幂等键或人工确认。

操作方法

1. 登记插件和基础服务地址。
2. 定义工具参数和返回结构。
3. 配置授权并执行测试调用。
4. 验证超时、限流、错误和撤销授权。

验收与边界

• 能说明本功能的输入、输出和权限边界。
• 能用一个最小示例验证配置生效。
• 真实生产数据和凭据未写入页面、仓库或日志。