模型名称是开发者手动填写的语义标识，用于配置与日志；API ID是系统生成的32位十六进制字符串，用于唯一绑定服务实例并路由请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要区分 Agent Space 中的模型名称和 API ID，必须明确二者在系统中的角色定位：模型名称是面向开发者的语义标识，用于在配置、调试、日志中快速识别能力类型；API ID 是系统内部唯一绑定服务实例的字符串，用于路由请求、权限校验与调用计费。
模型名称的作用与生成逻辑
模型名称由开发者在创建 Agent 时手动填写，支持中文、英文、数字和下划线，长度限制为 3～64 字符。
它不参与任何底层调度，仅用于控制台列表展示、YAML 配置文件中的 model_name 字段、以及错误日志中 human-readable 的上下文提示。例如写成 sales-forecast-v2 或 门店铺市分析助手 都合法，但不会影响实际执行路径。
注意：模型名称可重复——不同团队、不同空间（Space）下允许存在同名模型，【同一 Space 内重复命名会导致创建失败】。
API ID 的生成规则与不可变性
API ID 是系统在 Agent 发布成功后自动生成的 32 位小写十六进制字符串，形如 8a3f9c1e4d7b20569f8a1c4e7d2b9f0a。
该 ID 一旦生成就永久绑定当前 Agent 版本，即使重命名模型名称、修改提示词、更换 LLM 后端，API ID 也不会变更。
所有外部调用都必须使用此 ID 构造请求 URL：https://api.example.com/v1/spaces/{space_id}/agents/{api_id}/invoke。漏掉或填错一个字符，HTTP 返回 404。
如何在控制台快速定位二者
第一步：进入 Agent Space 控制台 → 左侧导航栏点击「Agent 管理」→ 找到目标 Agent 卡片。
第二步：卡片右上角显示的是模型名称（可编辑），点击右侧「详情」按钮 → 滚动至「部署信息」区域 → 查看「API ID」字段值。
第三步：若需批量导出，点击列表页右上角「导出 CSV」→ 文件中同时包含 model_name 和 api_id 两列，无映射歧义。
