添加模型

  • 文档创建者:Aria.Han
  • 历史版本:17
  • 最近更新:Aria.Han 于 2026-09-03
  •  1. 简介

    AI 大模型是 Agent 的底层智能引擎,Agent 在运行时必须绑定模型,模型负责自然语言理解、逻辑推理、SQL 生成、报告生成等核心能力。模型模块可以对平台内可供 Agent 调用的大模型进行统一配置与管理。

    2. 添加模型

    2.1 添加入口

    以超级管理员或有模型管理权限的开发者身份,进入「管理后台>模型」,点击右上角「添加模型」按钮,在添加模型弹窗中填入模型相关基础信息。

    2.2 基础信息

    填写项说明
    接口调用协议

    选择待添加模型符合的接口调用协议。

    当前支持如下三种协议:

    • OpenAI 兼容协议

    • Azure 兼容协议

    • Gemini 原生协议

    ApiKey输入模型官方提供的 API 密钥,用于身份验证
    EndPoint

    输入模型服务的 API 接口地址

    API-Version仅在 Azure 兼容协议下需填写
    Gemini 思考模式仅在 Gemini 原生协议下需填写
    模型名称

    输入模型服务提供商提供的官方模型名(model name)

    可选择「自动获取」以根据 ApiKey 等信息自动匹配模型名称。

    展示名称模型在 Dora 平台界面中显示的名称
    上下文窗口

    输入模型服务商提供的上下文长度参数

    例如:deepseek-v4-pro 官方提供的上下文长度为 1M,则此处填入 1000000

    以添加「deepseek-v4-falsh」模型为例,效果如下图所示:

    2.3 连接测试与保存

    填写完成后,点击「连接测试」,验证模型的对话、Tool Call 及思考模式等功能是否正常。连接测试期间,系统会检测并展示该模型支持的思考模式:

    • 自主思考:由模型自行决定是否启用思考模式,用户无法在对话框中手动开启或关闭;

    • 可控思考:用户可在对话框中手动选择开启或关闭思考模式。

    测试通过后,点击「保存」即可完成模型添加。

    注:

    1)新建模型必须完成「连接测试」后,才能正常识别并使用其思考模式。

    2)已有模型在新版本上线后,必须重新进行「连接测试」。

    3)在完成连接测试前,系统将统一按「自主思考」模式使用该模型;即使模型实际支持用户手动控制思考模式,对话框中也不会提供开启或关闭选项。

    0901迭代 06.gif

    3. 模型管理

    3.1 模型分类

    已添加的模型根据添加位置,按照「公共」和「我的」分类:

    • 在「公共」分页添加的模型可全员公开使用

    • 在「我的」分页添加的模型仅创建者个人可见、可用

    3.2 模型操作

    模型列表展示所有已添加的大模型,支持对已有模型做如下操作:

    • 搜索:通过顶部搜索框按模型名称快速定位目标模型;

    • 连接测试:悬浮并点击目标模型右侧的「... >连接测试」,验证模型的 API 连接是否正常,确保 Agent 可正常调用;

    • 删除:悬浮并点击目标模型右侧的「... >删除」,删除不再使用的模型。

    4. 注意事项

    1)免责声明:帆软仅提供大模型的推荐参考及对接方式,不对大模型本身的问题承担责任。

    2)模型删除后将无法恢复,操作前请确认是否被 Agent 引用。

    3)ApiKey 与 EndPoint 为敏感信息,需妥善保管,避免泄露。

    4)需确保网络环境可访问对应模型的 API 地址,否则连接测试会失败。

    5)模型名称需与服务商提供的完全一致,否则会导致 Agent 调用异常。

    附件列表


    主题: 模型配置
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!