发布失败需依次检查：欢迎语≥10字、示例对话补全、MCP工具已连接且开关启用、客户端≥v2.8.5、模型为DeepSeek-R1联网满血版、禁用蜂群协同推理、清除缓存并关闭SOCKS5代理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
纳米AI自建智能体发布失败时，界面卡在“发布中”或直接报错“服务不可用”，根本无法进入测试环节——这不是模型能力问题，而是发布链路中某一个环节未通过校验或未完成绑定。
确认智能体基础配置是否完整
打开「智能体编辑页」→检查左侧导航栏是否已填写全部必填项：名称、头像、简介、欢迎语。其中【欢迎语不能为空且长度必须≥10字】，否则发布按钮始终置灰，连提交请求都不会发出。
点击右上角「预览」按钮，观察弹窗是否能正常加载模拟对话框。若弹窗空白或提示“初始化失败”，说明系统未识别到有效指令模板，需返回「能力设置」中补全至少一条示例对话（如：“帮我查上周的会议纪要”→“好的，请提供会议时间范围”）。
验证工具调用权限与MCP绑定状态
若智能体启用了万能工具箱中的MCP工具，必须完成双向绑定：
方法一：直查工具箱连接状态
进入「智能体」页面→点击右上角「万能工具箱」→确认目标工具卡片右下角显示绿色「已连接」，而非灰色「未连接」或黄色「待授权」。
方法二：检查智能体能力开关
回到该智能体编辑页→下滑至「插件管理」区域→确认「允许调用MCP工具」已被勾选。【该开关默认关闭，不手动开启则发布流程会在校验阶段被强制拦截】。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
排查发布环境与版本兼容性
第一步：确认客户端为最新版
桌面端用户请打开「关于」→核对版本号是否 ≥ v2.8.5；网页端用户需刷新页面并清除浏览器缓存（Ctrl+F5），旧版前端会因API字段缺失导致发布请求被网关拒绝。
第二步：检查模型底座是否启用成功
在「模型广场」中确认当前选中的是「DeepSeek-R1-联网满血版(671B)」，且右下角状态栏显示“已连接|在线”。若显示“待连接”，请关闭软件后重启——刷新按钮无效，底层通道不会重置。
第三步：禁用实验性功能干扰
点击右上角头像→「设置」→「高级」→关闭「启用蜂群协同推理（Beta）」开关。该功能在v2.8.5中仍存在上下文注入冲突，会导致自建智能体发布时签名校验失败。
捕获真实错误日志定位根因
在智能体编辑页底部点击「发布」后，立即按下 Ctrl+Shift+I 打开开发者工具→切换到「Console」标签页→复现发布动作→截图或复制红色报错行（如 “403 Forbidden: missing tool_auth_token” 或 “validation failed: description too long”）。
若控制台无报错但发布按钮持续转圈，说明请求未发出：此时需检查网络代理设置，纳米AI发布接口（https://api.nanoai.com/v2/agents/publish）不支持 SOCKS5 代理，仅接受 HTTP/HTTPS 类型。
【旧缓存残留会导致发布请求携带过期的CSRF token，引发403错误；此时应关闭软件→按 Win+R 输入 %appdata%\NanoAI\cache →删除 entire_cache_v2 文件夹→重启再试】。
