GEO Agent Guide
模型 KEY 设置
BYOK 配置与各平台申请
模型 KEY 设置
GEO Agent 的 AI 成文、策略推荐、品牌诊断等功能，默认使用您在本机填写的 个人模型 API Key（BYOK，Bring Your Own Key）。Key 仅保存在您的电脑，由您直接向各 AI 平台付费，不再通过云擎星河 Platform 扣减算力。
在哪里配置
- 打开 GEO Agent 主对话页
- 点击左下角 「模型 KEY 设置」（侧栏底部）
- 在弹窗中完成配置后点 保存，建议先点 测试连接 确认可用
弹窗包含两个页签：
| 页签 | 用途 |
|---|---|
| 基础模型 | 品牌录入辅助、知识策略、批量成文、命题推荐等日常 AI 调用 |
| 诊断平台 | 品牌 AI 收录诊断：按豆包、DeepSeek、通义等平台分别配置 Key |
侧栏按钮下方会显示 「已启用个人 KEY」 或 「使用平台模型」；启用 BYOK 后应以「已启用个人 KEY」为准。
基础模型 KEY（成文 / 策略）
适用于文砚成文、维斯策略、星河资料补全等主流程能力。
操作步骤：
- 打开 模型 KEY 设置 → 停留在 基础模型 页签
- 勾选 「启用个人 API Key（BYOK）」
- 选择 提供商（DeepSeek / OpenAI 兼容 / 自定义），系统会预填常用 Base URL 与模型名
- 填写 API Key（密码框，保存后仅显示脱敏预览）
- 按需调整 模型名、超时时间
- 点击 测试连接，成功后再 保存
推荐起步配置（DeepSeek）：
| 项 | 参考值 |
|---|---|
| 提供商 | DeepSeek |
| Base URL | https://api.deepseek.com |
| 模型名 | deepseek-chat |
| API Key | 在 DeepSeek 开放平台创建 |
若使用 OpenAI 兼容 网关（含部分国内中转），选择对应提供商并填写对方文档中的 Base URL 与模型名即可。
诊断平台 KEY（品牌诊断）
品牌诊断会向多个 AI 搜索/对话平台发起探测，需为 诊断平台 页签中的各平台分别配置 Key（OpenAI 兼容接口）。
操作步骤：
- 打开 模型 KEY 设置 → 切换到 诊断平台 页签
- 左侧选择平台（豆包、DeepSeek、千问、Kimi 等）
- 勾选 启用，填写该平台对应的 Base URL、模型名、API Key
- 测试连接 → 保存
- 至少配置 1 个 平台；建议 优先配置豆包，否则无法启动完整诊断
各平台 Base URL / 模型名以控制台文档为准；Agent 内会预填常见默认值，若调用失败请对照下表更新。
各 AI 平台 KEY 申请指引
以下为常见平台的 注册入口 与 简要申请步骤（各平台政策与计费可能调整，以官网为准）。
| 平台 | 在 Agent 中的用途 | 申请步骤简述 | 注册 / 控制台 |
|---|---|---|---|
| DeepSeek | 基础成文、策略；也可用于诊断 | 注册账号 → 进入 API Keys → 创建 Key → 复制 sk- 开头密钥 |
DeepSeek 开放平台 |
| 豆包 | 品牌诊断（建议必配） | 注册火山引擎 → 开通「方舟」大模型 → 创建推理接入点 → 获取 API Key 与 Endpoint ID（模型名填接入点 ID） | 火山引擎方舟 |
| 通义千问 | 品牌诊断 | 注册阿里云 → 开通 DashScope（百炼）→ 创建 API Key → 使用兼容模式 Base URL | 阿里云百炼 / DashScope |
| Kimi | 品牌诊断 | 注册 Moonshot AI → 开放平台创建 API Key | Moonshot 开放平台 |
| 文心一言 | 品牌诊断 | 注册百度智能云 → 开通千帆大模型 → 创建应用并获取 API Key | 百度千帆控制台 |
| 腾讯元宝 | 品牌诊断 | 注册腾讯云 → 开通混元大模型服务 → 在控制台创建 API 密钥 | 腾讯云混元 |
| OpenAI 兼容 | 基础模型（可选） | 在所用服务商控制台创建 API Key，Base URL 填对方提供的兼容地址 | 以您所选服务商文档为准 |
豆包（火山方舟）补充说明： 控制台创建的是「推理接入点」，模型名 通常填写接入点 ID（形如 ep-xxxx），Base URL 一般为 https://ark.cn-beijing.volces.com/api/v3（地域以控制台显示为准）。
安全与隐私
- API Key 仅保存在本机 GEO Agent 数据目录，不会写入对话内容或上传到媒体平台
- 请勿将 Key 提交到代码仓库、截图或发给他人
- 更换 Key 时：在设置中填入新 Key 保存即可；留空 Key 框并保存表示 不修改 已保存的 Key
- 若 Key 泄露，请立即在对应平台 作废并重新创建
常见问题
提示需要 BYOK / 未配置 Key？
打开 模型 KEY 设置，确认已勾选「启用个人 API Key」且测试连接成功；诊断类功能还需在 诊断平台 页签配置对应平台。
成文失败但 Key 已配置？
- 点击 测试连接 查看具体报错
- 检查余额是否充足（向 AI 平台 充值，非 Platform 算力）
- 核对模型名、Base URL 是否与平台文档一致
诊断提示「请配置豆包」？
在 诊断平台 页签为 豆包 单独保存有效 Key 后重试。