#快速上手

本章用 Chatbot 完成第一条对话：先有一个可用模型，再写一句系统提示，在预览窗里发消息。不接知识库、不加工具——那些放到后面章节。

#0. 先接入一个模型

没有模型供应商，Studio 里无法跑通预览。

1. 用 Owner / Admin 打开工作空间的 Integrations → Model Provider（界面文案可能是「集成 / 模型供应商」）
2. 安装 OpenAI、Anthropic，或国内常用的 DeepSeek、通义千问（Qwen / Tongyi）
3. 点供应商卡片上的 Setup / 设置，填入 API Key（以及如有需要的自定义 Endpoint）
4. 等 Dify 校验通过 后再继续

只用本机模型时，改走 接入 Ollama，再回到这里。Cloud 若自带试用额度，也可以先用额度里的模型，不必马上贴自己的 Key。

工作空间还可以设置 Default Models（默认推理模型、Embedding 等），未单独选模型的应用会回落到这里。详见 模型供应商。

#1. 创建一个 Chatbot

在 Studio 里新建应用，类型选 Chatbot（官方也推荐 Workflow / Chatflow；Hello World 用 Chatbot 步骤最少）。

填写：

• 名称：例如 hello-dify
• 描述（可选）：方便以后在列表里找
• 提示词：先写短、可验证的人格，例如：

你是垦荒学园的助教。用简洁中文回答。
若问题超出常识、且没有提供资料，就明确说不知道，不要编造。

保存后进入编排页。右侧一般是 Debug / Preview（调试与预览）：选刚接入的模型，发一条「用一句话介绍你自己」。

成功标志： 几秒内出现助手回复，而不是「未配置模型 / provider_not_initialize」一类错误。

#2. 第一次对话在测什么？

如果回复很「闲聊」、不守约束，先改提示词再测，不要急着上知识库。能稳定复现「听指令」之后，再接到 知识库。

可选能力（名称以你当前版本的 App Toolkit 为准）：开场白、追问建议、内容审核等。第一课可以全关，减少变量。

#3. 换模型对比（可选）

同一条用户消息，在预览里换一个更小或更便宜的模型再发一次。观察：

• 延迟与语气是否可接受
• 是否仍然遵守「不知道就说不知道」
• 中文指令跟随是否变差

Agent 预览里还有「多模型调试」（最多约 4 路并行）；Chatbot 至少也能手动换模型对比。这比一上来接 10 个供应商更有用。

#4. 最小发布（可选）

预览满意后点 Publish / 发布。可以先只开 Web App：会得到一个可分享的对话页，方便同事点开试，而不必登录 Studio。API Key 与 curl 放到 发布与 API。

注意：Service API 的会话与 Web App 不共享 conversation_id——同一 user 在两边也是两套历史。

#第一个任务清单

1. Cloud 或 http://localhost 登录
2. 接入一个供应商并校验成功
3. 新建 Chatbot，写 3 行提示词
4. 预览里完成一问一答
5. （可选）换模型对比；发布 Web App 给另一台浏览器打开

#常见卡点

预览报未配置模型？ 回到 Model Provider，确认 Key 校验通过，且应用里真的选中了该模型。

国内访问 OpenAI 超时？ 换 DeepSeek / 通义，或自托管后接 Ollama。

只会「我是 ChatGPT」？ 提示词写清身份与拒答规则，并确认选中的是你配置的那个模型而非平台默认闲聊模型。

#下一步

• 模型供应商
• 知识库
• 实战案例