模型未显示是因未在agentspace后端注册，需通过api验证、控制台添加模型、检查前端请求响应及cli绑定四步排查。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在 AgentSpace 中配置了模型但启动后提示“model not available”或模型列表为空，说明平台未能成功加载或识别你指定的模型服务。这通常不是模型本身下线，而是配置路径中断、权限未就绪或网关路由不匹配导致的。
检查模型是否已在 AgentSpace 后端注册
AgentSpace 不会自动拉取你本地或第三方服务上的所有模型，它只信任明确注册进其模型目录的 ID。
第一步：打开终端，执行 curl -H "Authorization: Bearer YOUR_API_KEY" https://api.agentspace.dev/v1/models（将 YOUR_API_KEY 替换为你在 AgentSpace 控制台生成的密钥）。
第二步：在返回的 JSON 列表中搜索你配置的模型名，例如 【gpt-5.6-sol】 或 【gemini-2.0-flash-exp】。如果完全找不到，说明该模型尚未被 AgentSpace 后端接纳，后续所有调用都会失败。
第三步：若未查到，不要手动修改前端配置或重试请求——直接前往 AgentSpace 控制台的「Model Registry」页面，点击「Add Model」，填入完整模型 ID、提供商类型、认证方式和健康检查端点。只有完成这一步，模型才真正“存在”于 AgentSpace 的调度体系中。
验证模型配置是否被前端正确读取
即使后端已注册模型，AgentSpace UI 仍可能因缓存、配置文件错位或环境变量覆盖而显示为空。
方法一：清除浏览器缓存并硬刷新（Ctrl+Shift+R），然后进入 Settings → Model Preferences，确认「Default Model」下拉菜单是否可选。若仍为空，说明前端未收到模型元数据响应。
智能订单处理助手，帮助用户快速创建WMS发货单。 当用户请求以下操作时使用： 1. 采购/下单/创建发货单（如"帮我采购一本书"、"帮我下单"） 2. 批量处理订单（如"帮我完成这个表格中所有订单的发货"） 3. 从Excel/CSV文件导入订单 支持从标准格式的Excel表格中提取：商品名称、数量、ISBN、收...
方法二：打开浏览器开发者工具（F12）→ Network 标签页 → 刷新页面 → 筛选 fetch/XHR 请求 → 找到 /v1/models 请求 → 查看 Response 内容。如果返回空数组或 403 错误，问题出在 API 权限或网关代理层，不是你本地配错了。
注意：如果你正在使用自托管 AgentSpace 实例，检查 【AGENTSPACE_MODEL_REGISTRY_URL】 环境变量是否指向了正确的内部模型注册服务地址，而非默认的 public endpoint。
跳过 UI，用 CLI 强制触发模型绑定
当 UI 卡在“加载中”或配置项灰显时，命令行是唯一能绕过前端限制、直连配置逻辑的通道。
在部署 AgentSpace 的服务器上运行：agentspace model bind --provider openai --endpoint https://api.openai.com/v1 --api-key sk-xxx --model gpt-5.6-sol。
执行后观察终端输出。若出现 Binding successful. Model gpt-5.6-sol now active for workspace default.，说明底层配置已生效；此时刷新 UI，模型应立刻出现在下拉菜单中。
如果报错 Failed to reach registry: connection refused，证明 AgentSpace 后端服务与模型注册中心网络不通，需检查防火墙策略或 service mesh 配置。
