顶级AI顶级AI
开发者参考

在线工具边界

在线工具能力后续单独设计,当前文档只说明边界和预留方向。

当前只是入口说明

在线工具页后续会单独设计真实调用、计费、审计和缓存边界。当前文档只说明方向,不新增后端工具 API 契约。

当前状态

/tools 是公开在线工具入口的预留页面。它可以展示未来能力方向,但当前不直接接入真实模型调用,也不绕过 Go 后端的鉴权、余额、扣费和审计。

未来设计原则

  • 工具页不能直连 provider,也不能保存 provider key。
  • 真实模型调用必须走 Go 后端,继续复用用户、余额、usage、ledger 和调用日志。
  • 如果新增工具 API,命名空间需要单独设计,当前候选是 /api/tools/*
  • 工具页产生的费用、错误和历史记录,要能被用户和管理员追踪。

这和工具接入教程的区别

“工具接入教程”是教用户把顶级AI填进外部客户端。“在线工具边界”是说明顶级AI站内工具页未来怎么设计,两者不是同一个功能。