通用工具配置
根据工具提示选择协议，并填写正确的 Base URL 或完整接口地址。
当一个 AI 工具没有单独的 AIDesk 教程，但提供「自定义模型」「自定义提供商」或「兼容 API」入口时，可以按本页规则完成配置。
判断使用哪种协议
看工具页面中的协议名称、接口路径或帮助文字，不要按模型厂商判断。AIDesk 会在后端完成模型路由与协议转换。
看到 OpenAI、Chat Completions 或 Responses
选择 OpenAI 兼容协议。Chat Completions 与 Responses 都属于 OpenAI 格式，完整接口路径不同。
看到 Anthropic 或 Messages
选择 Anthropic 兼容协议。使用 Base URL 时，工具通常会自动请求/v1/messages。
确认地址输入框的类型
同一个协议既有基础地址，也有完整接口地址。填错类型最常见的结果是路径被重复拼接并返回 404。
输入框写 Base URL、API Base、Host 时，填写基础地址，让工具自动拼接请求路径。
输入框或帮助文字明确写出/chat/completions、/responses或/messages时，填写对应的完整接口地址。
如果字段只写「接口地址」且没有路径提示，先查看输入框占位符或工具帮助，确认它是否会自动追加请求路径。
可直接复制的接口地址
域名会跟随当前部署环境自动变化。请复制本页显示的完整值。
OpenAI 兼容地址
https://api.aideskapp.com/v1工具会自动拼接请求路径时使用
https://api.aideskapp.com/v1/chat/completions页面明确要求 chat/completions 时使用
https://api.aideskapp.com/v1/responses页面明确要求 responses 时使用
Anthropic 兼容地址
https://api.aideskapp.comAnthropic SDK 或工具自动拼接 /v1/messages 时使用
https://api.aideskapp.com/v1/messages页面明确要求 messages 完整路径时使用
chat/completions 和 responses，两者结尾都是复数。其他字段怎么填
不同工具的字段名会有差异，但含义基本一致。
提供商 / Provider
自定义 / Custom
协议 / API Format
按页面提示选择 OpenAI 或 Anthropic
API Key
sk-aidesk-YOUR_KEY
配置示例
以 WorkBuddy 为例
页面写明「仅支持 OpenAI 兼容协议 API」，并要求填写 Chat Completions 完整接口地址，因此这样配置：
- 提供商
- 自定义 / Custom
- 接口地址
- https://api.aideskapp.com/v1/chat/completions
- API Key
- sk-aidesk-YOUR_KEY
- 模型名称
- gpt-6.1-sol
模型名称只是示例，请从模型列表复制当前可用的完整模型 ID。工具调用、图片输入、思考模式等开关按模型能力和使用需求设置。
常见问题
保存后返回 404
优先检查工具是否已经自动追加路径。不要把 /v1、/chat/completions、/responses 或 /messages 重复填写。
返回 401 或提示 API Key 无效
重新复制完整 Key，删除首尾空格，并确认 Key 没有在控制台被禁用。
提示协议或请求格式不支持
重新查看工具声明的是 Chat Completions、Responses 还是 Anthropic Messages，选择与提示一致的协议和路径。
提示模型不存在
模型名称必须与模型列表中的 ID 完全一致，包括大小写和连字符。