nexent-integration
Installation
SKILL.md
Nexent 智能体集成（六大方向）
配套平台版本：2.5.0（接口/字段/端口均以该版本为准；跨版本使用请先以各服务
/openapi.json实测校准）。
配套技能：智能体 UI 设计与真机测试 →
agent-ui-design-and-testing；技能质量检查 →skill-qc。
整合华为开源 Nexent 智能体平台的全部对接经验，分为六大方向：
| 方向 | 内容 | 参考文档 |
|---|---|---|
| 方向一：北向接口调用 | 从外部 Web 系统调用智能体：agent 发现、POST /nb/v1/chat/run、SSE 流式、Bearer 鉴权、conversation_id 追问、附件/文件上传（/nb/v1/chat/attachments/upload + 知识库文件上传） |
references/01-northbound-api.md |
| 方向二：流式输出经验 | SSE 事件协议本质（thinking 增量/final_answer 一次性）、conversation_id 响应头、协议层踩坑（空请求体 422/conversation_id 误渲染）、提示词契约；前端呈现（三层架构/滚动三态/图表 init/弹窗解耦/真实浏览器验证）详见 agent-ui-design-and-testing 技能 streaming-ui.md |
references/02-streaming-guide.md + agent-ui-design-and-testing/streaming-ui.md |
| 方向三：远程操控提示词与发布 | 管理 API（登录 session 鉴权、agent_id 查询、search_info/update、技能管理 API（/api/skills 创建/上传/更新/scan_skill/nl2skill + 脚本型技能 run_skill_script 执行机制）、版本 publish 递增与命名规则） |
references/03-admin-api.md + scripts/nexent_agent.py |
| 方向四：MCP 工具接入与联调 | API 转 MCP（/tool/openapi_service）、工具扫描/绑定、MCP 仓库注册（/api/mcp/add）、接入已有远程 MCP 服务器（healthcheck/tools/refresh-tools）、config_json 补配置、SSE 协议探测、OpenAPI 对接与裁剪、端口速查 |
references/04-mcp.md |
| 方向五：加载与调用原理 | 提示词草稿/发布两态、技能渐进式加载（read_skill_md 命中后读全文）、工具绑定与 thinking 可见调用、技能命中验证方法论、技能使用规则 prompt 模板 | references/05-prompt-skill-tool-loading.md |
| 方向六：环境探查 | 新建智能体前的全量环境摸底（网络/鉴权/模型/知识库/智能体现状/技能/MCP/工具），更新智能体时的按需探查（仅查相关维度） | references/06-environment-probe.md |