Dify · Agent
Dify 接入 Tikway：OpenAI 兼容模型配置与 Agent 验证
更新日期：
Dify 可以通过 OpenAI 兼容模型供应商，把自有 AI 应用连接到 Tikway。先在工作区配置模型供应商，再把模型用于 Chatflow 或 Agent，是比较容易排错的接入顺序。本文介绍配置字段、模型与工具的分开验证，以及常见鉴权和路径问题。
1. 接入前需要什么？
你需要有模型供应商管理权限的 Dify 工作区、Tikway API Key，以及模型目录中的完整文本模型 ID。Agent 还需要所选模型支持工具调用；如果先做普通聊天，可以先只验证 Chat Completions。
Tikway 的 OpenAI 兼容 Base URL 是 https://api.tikway.ai/v1。完整聊天端点是 https://api.tikway.ai/v1/chat/completions，不要把两个地址混填。
这是一份配置与自检指南，尚未用你的 Dify 版本、账号和模型完成端到端调用测试。保存模型时插件可能发起短请求验证凭据；模型测试、预览和应用运行也会产生适用的模型费用。
2. 添加 OpenAI 兼容模型供应商
在 Dify 工作区的**设置 → 模型供应商（Model Providers）**寻找 OpenAI-API-compatible。如果未安装，在 Marketplace 的模型供应商分类查找并安装官方兼容插件，再返回设置。不要因为名称接近就安装不明来源插件。
添加自定义模型时，按以下对应关系填写。官方插件使用 API Base URL、API Key、Function Call Type 等字段；不同 Dify / 插件版本的译名和位置可能不同，以所安装版本的表单为准。
| 配置项 | 填写方式 |
|---|---|
| 模型名称 / Model Name | Tikway 目录中的完整模型 ID，保留前缀和大小写 |
| API endpoint 中的模型名称 | 如填写此覆盖字段，也填同一个完整 ID；未填写时使用模型名称 |
| 模型类型 / Model Type | LLM，选择适用于文本聊天的模型 |
| API Key | 从 Tikway 控制台创建的 Key |
| API Base URL | https://api.tikway.ai/v1 |
| Completion Mode | 如有此字段，选 Chat，而不是旧式 Completion |
| 上下文与输出限制 | 按所选模型详情与插件字段配置，不复制别人的大数值 |
| 函数调用类型 / Function Call Type | 工具测试时选“工具调用 / Tool Call”；默认“不支持 / Not Support”不会声明工具能力。仅对支持的型号启用 |
保存后，用该模型发送“只回复 OK”的短请求。如果出现错误，先解决供应商连接，再继续搭建 Agent，避免把路径错误和工具错误混在一起。
3. 供应商 Key 与 Dify 应用 Key 有什么区别？
Tikway API Key 用于 Dify 请求 Tikway 模型，填在工作区模型供应商的凭据中。
Dify 应用 API Key 用于你自己的前端或服务访问已经发布的 Dify 应用，填在调用 Dify 应用 API 的客户端中。它不能代替供应商 Key，也不能直接用于 Tikway /v1/chat/completions。
先在 Dify 内部预览确认模型与工作流正常，再考虑通过 Dify 应用 API 对外调用；这是两段独立的连接。
4. 从 Chatflow 逐步验证到 Agent
先创建简单的 Chatflow：用户输入连接 LLM 节点，再连接回答节点。LLM 节点选择刚添加的 Tikway 模型，用一个简短问题检查输出。此步骤只确认聊天链路。
接下来在 Agent / Agent 节点里选择该模型，并按当前版本选择支持的 Agent 策略。选择 Function Calling 或 tool-calling 策略前，确认模型和插件均支持工具调用；普通 LLM 响应不能替代这个确认。ReAct 是另一种策略，也需要单独测试模型输出格式和工具执行，不等于自动兼容。
添加一个只做算术的工具，例如可信 Calculator 工具，或自行创建的加法工作流工具。只给它两个整数输入和求和结果，不接邮件发送、付款或业务数据修改。设置明确的工具说明，再用“使用加法工具计算 17 + 25，然后报告结果”作为测试问题。若当前版本提供最大迭代次数，先设为 3。
5. 什么才算工具流程验证成功？
在 Dify 预览、运行详情或 Trace 中核对：
- 实际选择了你添加的 Tikway 模型，文本响应正常。
- Agent 明确发起了目标工具调用，参数与测试任务相符。
- 工具执行成功，返回
42，随后结果进入模型的下一步处理。 - 最终回答完成，流程没有陷入反复重试或耗尽迭代上限。
- 同一时间的 Tikway 调用记录能对应请求、型号、用量和费用。
仅看到最终答案“42”，不能证明工具被执行。供应商表单保存成功，也不能证明所选模型的 Agent 功能已通过验证。
6. 常见问题
401 是 Dify 的 Key 错了吗？ 先看失败发生在 Dify 应用 API 还是 Tikway 供应商请求。两者 Key 不同；检查实际鉴权头、工作区配置是否保存，以及 Key 是否多了空格。参考 API 401 排查。
为什么返回 404 或 HTML？ 检查最终模型请求路径应为 /v1/chat/completions，没有重复 /v1 或 /chat/completions，没有误用官网 /api 地址。
模型列表里找不到型号怎么办？ 兼容插件通常允许手动添加模型。复制 Tikway 目录的完整 ID；不要自行把 ID 改成显示名称，也不要把拉取列表失败当成所有模型均不可用。
普通聊天能用，Agent 为什么失败？ 检查模型的工具能力、插件能力声明、Agent 策略、工具 schema、参数和执行日志。暂时减少工具数量，用一个小工具定位问题。
怎样控制预算？ 限制迭代、历史长度和工具结果大小。用费用计算器估算每轮文本费用，再用实际用量核对；Dify 的工作流可能发起多次模型请求。
继续阅读：Agent API 接入与模型选择 · LangChain 工具调用教程 · n8n AI Agent 配置 · 模型目录
参考：Dify 模型供应商文档 · 官方 OpenAI 兼容插件字段。插件版本、Agent 策略和字段会变动，安装后应按当前界面和运行详情核对。