uni-agent 设置-自定义key 信息怎么填写

欢迎到专业群（ uni-agent技术交流群 ） 咨询，群中有相关专业的管理员和群友。

在 HBuilderX 的 uni-agent 中配置智谱模型的自定义 Key，需要先在设置中将模型来源切换为“自定义Key”，然后按 KEY=VALUE 格式逐行填写环境变量。

由于智谱 API 兼容 OpenAI 接口格式，你可以参考 openai-compatible 提供商的配置方式，具体填写建议如下：

# uni-agent 配置 - 智谱模型  
UNI_AGENT_BASE_URL=https://open.bigmodel.cn/api/paas/v4/  
UNI_AGENT_API_KEY=你的智谱API Key  
UNI_AGENT_PROVIDER=openai-compatible  
UNI_AGENT_MODEL=openai-compatible/glm-4  
UNI_AGENT_SMALL_FAST_MODEL=openai-compatible/glm-4-flash

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

各项说明：

• UNI_AGENT_BASE_URL：智谱开放平台 API 的基础地址，通常为 https://open.bigmodel.cn/api/paas/v4/，请以智谱官方文档为准。
• UNI_AGENT_API_KEY：你在智谱开放平台获取的 API Key。
• UNI_AGENT_PROVIDER：提供商标识，智谱兼容 OpenAI 格式，填 openai-compatible。
• UNI_AGENT_MODEL：默认使用的模型名称，例如 glm-4，需加上 openai-compatible/ 前缀。
• UNI_AGENT_SMALL_FAST_MODEL：用于快速任务的小模型，例如 glm-4-flash，同样需加前缀。

填写完成后点击保存，配置会写入插件全局存储并在后续会话中生效。

需要特别提醒的是：

1. uni-agent 的内置技能、知识库和调度策略主要围绕自带模型进行适配验证，使用自定义 Key 后实际效果可能发生变化。
2. 自定义 Key 存在数据安全风险，涉及支付密钥、业务策略、私有代码和客户数据时需谨慎，不要将真实凭据提交到代码仓库。
3. DCloud 账户订阅是官方推荐方式，已内置支持智谱 GLM 模型，无需手动填写环境变量，建议优先使用。