配置并开始使用
本页介绍 Dora 的系统要求、安装部署、大模型配置和首次验证。Dora 以插件形式集成在 DDM Client 中，需要先完成大模型配置才能工作；当前版本只需更新 DDM Client，DDM Server 不需要更新。
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows，其他操作系统暂不支持 |
| 硬件配置 | 4 核 CPU、8GB 内存、50GB 磁盘空间 |
安装部署
- 从 Datablau 获取 DDM Client 安装包。
- 双击安装文件，按照安装向导完成安装。
- 在开始菜单中启动 DDM 工具。客户端右侧会在数据标准面板旁边新增“智能建模助手”面板；看不到该面板时参见常见问题。
配置大模型
- 启动 DDM，在右侧“智能建模助手”面板的工具栏单击最后一个按钮，展开扩展功能工具条。
- 选择“模型配置”按钮，进入大模型配置页面，可在此增加、编辑、删除大模型。
- 填写以下四个参数后保存。
| 参数 | 说明与填写要求 |
|---|---|
| 提供商名称 | 标识服务提供方的自定义名称，用于区分不同模型供应商，例如“企业内部大模型”。 |
| 大模型名称 | 要调用的具体模型名称或版本标识，必须与服务端一致，请从贵司大模型管理员处获取。 |
| 大模型地址 | 服务接口的访问地址，例如 https://api.openai.com/v1/。地址不需要包含 chat/completions，客户端会按需自动增补。 |
| API 密钥 | 访问服务所需的身份验证密钥，应妥善保管，避免泄露到对话、文档或截图。 |
常见填写误区：地址末尾多写了 /chat/completions 导致请求路径重复；模型名称填写了界面显示别名而不是服务端真实模型 ID；密钥前后带空格或使用了已过期、已注销的密钥。
选择当前大模型
在智能建模助手工具栏单击“选择大模型”按钮，在弹出菜单中选择需要使用的大模型，即设为当前大模型。配置了多个模型时，每次会话使用的是当前选中的模型。
大模型规格要求
| 要求 | 说明 |
|---|---|
| 能力要求 | 必须支持 Function Call（函数调用），否则无法完成建模工具调用 |
| 推荐量级 | 建议使用企业可获得的旗舰级大模型，参数规模达到千亿级以上 |
| 不推荐 | 32B 及以下的小参数模型经实测效果不佳，不建议使用 |
| 选型原则 | 企业内部部署时选择能力最强的可用模型，具体型号向大模型管理员确认 |
首次验证
打开一个测试模型，在 Chat 对话框中依次输入以下提示词，逐项确认结果：
- 输入“新建一个客户实体”，对话框进入思考过程，并在当前 Diagram 中创建实体。
- 输入“在当前模型中，给客户实体添加一个联系电话的属性”，确认实体新增了该字段。
- 输入“在当前模型中，给客户实体添加红色背景样式”，确认实体背景变为红色。
三项结果都与指令一致，说明智能体已正常工作。之后即可根据实际需求输入提示词，让 Dora 完成建模任务；验证用的测试模型可以关闭或撤销，不要在首次验证时直接修改正式模型。
常见问题
大模型配置页面测试报错
配置页报错的原因较多，推荐分段排查：先用脚本在 Windows CMD 中直接测试大模型服务连通性。
@echo off
curl https://大模型地址/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer sk-您的密钥" -d "{ \"model\": \"模型名称\", \"messages\": [{ \"role\": \"user\", \"content\": \"Hello\" }], \"max_tokens\": 20 }"
pause把地址、密钥和模型名称替换为贵公司的实际值，建议保存为 BAT 脚本文件执行，避免多行命令在 CMD 粘贴失败。脚本成功而配置页失败时，回查四个配置参数。
Chat 输入内容后返回 401
通常是大模型的服务地址或 API 密钥配置不正确，逐项核对后重新测试。
安装后看不到智能助手
需要安装 WebView2 运行时，安装包分 x86 和 x64，可从 https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/ 下载；下载不方便可联系 Datablau 获取离线安装包。安装需要本机软件安装权限，没有安装权限的电脑无法支持。
是否支持建表引用数据标准、引用企业内部知识
两者当前版本均支持：建表落标见使用数据标准、知识库和附件；企业内部知识可通过知识库或文件附件提供。
完成验证后，继续阅读使用对话和可视化建模。