数据智能体
数据智能体
- 文档首页
数据智能体iDA管理后台智能体管理模型接入
复制全文
下载 pdf
文档反馈
问问助手模型接入页用于集中管理租户下需要接入或已接入的模型，并为不同模型类型维护可用接入来源。页面入口为后台管理 > 智能体管理 > 模型接入，进入后可查看已接入模型列表，并通过右上角 添加模型 新增接入配置。
在添加模型前，请先确认以下条件。
权限与环境
- 已登录对应租户的控制台，并具备模型接入管理权限；
- 已获取模型供应商、模型推理接入点、模型名称、api_key 等接入信息。
配置规则
- 每种模型类型仅允许设置一个默认模型；
- 选择火山方舟或火山 Agent Plan 时，系统会预填 base_url；如页面展示提示信息，可通过鼠标悬停查看；
- 大模型应用防火墙仅用于需要防护域名的接入场景。
注意
删除模型会影响后续模型选择和调用。若该模型是当前类型的默认模型，请先确认已有替代模型或业务允许短时间无默认模型。
本章节用于指导管理员完成一次新的模型接入配置。操作前请先准备好供应商信息、推理接入点、模型名称和 api_key；配置过程中按页面顺序填写字段，先完成连接测试，再保存并回到列表核对状态。
- 使用账号密码登录火山引擎控制台，选择数据智能体>选择项目后进入产品内。
- 在智能体列表单击对应智能体进入问答界面，鼠标移入左下角用户名单击后台管理。
- 通过后台管理侧边导航选择智能体管理 > 模型接入，右上角单击添加模型按钮，填写相关配置项。以下是配置项说明：
配置项 | 是否必填 | 填写说明 |
|---|---|---|
模型类型 | 是 | 选择模型的能力类型。下拉选择文本模型、多模态模型、图片生成模型、视频生成模型。 |
提供商 | 是 | 选择模型来源。支持火山方舟、火山 Agent Plan、大模型应用防火墙。 |
模型推理接入点名称 | 是 | 填写便于识别的接入点名称，建议包含模型用途或供应商信息。 |
模型推理接入点 | 是 | 填写平台分配的推理接入点 ID 或接入地址。 |
模型名称 | 是 | 从下拉框选择当前模型类型下允许使用的模型。 |
api_key | 是 | 输入模型接入所需密钥。密钥默认隐藏，保存后不会在列表明文展示。 |
接入防火墙 | 条件必填 | 如果模型调用需要防火墙安全控制，勾选 接入防火墙 选项，并按页面提示填写防护域名。 说明 当前模型类型为图片生成模型或视频模型时，不选择大模型应用防火墙作为提供商。 |
- 完成必填项后，点击测试连接。等待系统校验模型推理接入点、模型名称和 api_key。
- 测试通过后点击保存。返回列表后，确认新增模型出现在对应模型类型列表中，且状态为已配置。
问题内容 | 解答 |
|---|---|
列表中为什么看不到 api_key？ | api_key 不在列表展示，避免密钥泄露。需要更新密钥时，按当前系统支持的编辑或重新接入流程处理。 |
为什么模型名称下拉框没有可选项？ | 优先检查模型类型、提供商、模型推理接入点和 api_key 是否已填写正确。模型名称下拉框只展示当前模型类型下允许使用并可返回的模型。 |
什么时候需要配置防火墙？ | 当模型调用入口需要安全控制，或提供商选择大模型应用防火墙时需要配置。普通火山方舟或火山 Agent Plan 接入通常不需要额外填写防护域名，具体以页面提示为准。 |
SaaS 和私有化都在这里配置吗？ | 不是。SaaS 使用模型接入页面进行产品维度模型接入；私有化环境继承 Minibase 模型管理，不重复建设该接入页面。 |
智能体级模型配置是否需要在本页面完成？ | 本页面处理产品维度的模型接入。智能体级模型配置用于在可用模型范围内选择默认模型或允许用户在会话端切换模型，可在智能体模型配置中配置。 |