开发者参考
在线工具边界
在线工具能力后续单独设计,当前文档只说明边界和预留方向。
当前只是入口说明
在线工具页后续会单独设计真实调用、计费、审计和缓存边界。当前文档只说明方向,不新增后端工具 API 契约。
当前状态
/tools 是公开在线工具入口的预留页面。它可以展示未来能力方向,但当前不直接接入真实模型调用,也不绕过 Go 后端的鉴权、余额、扣费和审计。
未来设计原则
- 工具页不能直连 provider,也不能保存 provider key。
- 真实模型调用必须走 Go 后端,继续复用用户、余额、usage、ledger 和调用日志。
- 如果新增工具 API,命名空间需要单独设计,当前候选是
/api/tools/*。 - 工具页产生的费用、错误和历史记录,要能被用户和管理员追踪。
这和工具接入教程的区别
“工具接入教程”是教用户把顶级AI填进外部客户端。“在线工具边界”是说明顶级AI站内工具页未来怎么设计,两者不是同一个功能。