Nanobot 智能体

一、Nanobot 智能体概述

1.1 什么是Nanobot 智能体

Nanobot 智能体是低代码搭建工作流式智能体中的高阶自治型智能体节点组件（Action Node）。区别于传统的大模型（LLM）节点或简单代理（Agent），Nanobot 智能体相当于在工作流中植入了一个具备"独立思考、自主规划、工具/技能调用、并拥有长效记忆"的超级微型机器人。

1.2 核心价值

  • 全自治执行：无需人工干预，自动完成从意图理解到任务执行的全流程
  • 高并发支持：独创双层沙盒隔离机制，完美支持高并发流转
  • 技能扩展：无缝对接全局技能管理体系，支持原生与自定义技能的动态扩展
  • 开箱即用：自带内置工具，无需额外配置即可使用
  • 可观测性：实时查看内部思考过程，方便调试和优化
  • 远控通道集成：支持对接钉钉、飞书、企业微信等远控平台，可直接通过远控通道与智能体对话交互

1.3 核心能力

能力分类 具体功能 说明
全量Agent能力集成 模型提供商配置 支持配置对接的模型及API Key
System Prompt 支持设定全局人设与强制指令
MCP工具接入 支持接入标准MCP工具流
多轮对话 支持多轮对话能力
双层沙盒隔离 节点配置共享 所有并发请求共享读取节点配置
会话运行隔离 每个会话独立运行环境，无干扰
被动消费型技能树 全局技能对接 无缝对接AgentX Server全局技能管理体系
动态扩展 支持原生与自定义技能的动态扩展
低侵入式状态可观测性 运行日志查看 复用Langflow原生日志面板，透视内部思考过程
记忆系统 长效记忆 保留Nanobot长期/短期记忆能力
远控通道集成 多远控平台支持 支持对接钉钉、飞书、企业微信等主流远控通道平台
通道预激活 无需在试验场发送消息，点击运行组件即可预激活通道监听
消息统一处理 远控平台消息自动流入智能体执行引擎，统一处理后返回结果

二、使用流程

2.1 标准使用流程

步骤1：拖拽编排

  1. 用户从左侧组件菜单将 Nanobot Agent 拖入画布
  2. 系统后台自动创建对应 {Node_ID} 配置目录

步骤2：连线输入

  1. 用户将 会话输入 节点连接到 Nanobot 的 会话输出 输入桩
  2. 系统自动为每次请求生成唯一会话 ID（无需用户手动配置）
  3. 可选：连接 智能体指令 输入桩，动态传入人设指令
  4. 可选：连接 工具 输入桩，接入自定义MCP工具流

步骤3：按需配置

用户点击节点，在配置面板进行配置：

  1. 选择模型提供商并配置API Key
  2. 点击"技能"下拉框获取可用技能列表，勾选需要启用的技能

步骤4：触发执行

  1. 用户在工作流对话框输入自然语言指令
  2. 工作流引擎将请求带入Nanobot节点开始执行

步骤6：结果输出

  1. Nanobot执行完成后，通过会话输出桩返回最终自然语言回复

三、使用场景示例

3.1 时序地类变化分析

💡 以下场景演示上述标准流程的实际应用

需求：分析2022-2023年耕地的变化情况

配置步骤（对应标准流程）：

  1. 【流程步骤1】拖拽Nanobot Agent到画布
  2. 【流程步骤2】将会话输入连接到Nanobot的输入桩，输出桩连接到会话输出节点
  3. 【流程步骤3】智能体配置：
    • 选择qwen-turbo模型
    • 勾选时序地类变化分析助手技能
    • 接入自定义MCP工具流（ gpa-mcp-v2-common、gpa-mcp-v2-vectoranalyst、gpa-mcp-v2-datamanager、 gpa-mcp-v2-dataprocess）
  4. 【流程步骤4】运行时输入指令："帮我分析2022-2023年耕地的变化情况"

执行过程：

  1. Nanobot自动识别分析需求
  2. 调用时序地类变化分析助手技能处理数据
  3. 自动分析计算2022-2023年耕地的变化情况
  4. 生成结构化分析报告输出

四、远控通道集成使用

4.1 功能说明

Nanobot Agent支持对接钉钉、飞书、企业微信等远控通道集成，实现通过远控通道平台直接与智能体对话。

4.2 支持的远控通道

通道类型 接收方式 状态
钉钉 (DingTalk) WebSocket Stream ✅ 已支持
飞书 (Feishu) WebSocket 长连接 ✅ 已支持
企业微信 (WeCom) WebSocket 长连接 ✅ 已支持

4.3 配置步骤

  1. 管理员在后台管理中配置远控通道凭证（钉钉/飞书/企业微信的应用凭证）
  2. 在Nanobot节点配置面板的"远控通道"下拉框中选择需要绑定的通道
    • 已被其他工作流绑定的通道会显示为禁用状态
    • 选择"不绑定通道"可解除当前绑定
  3. 点击节点右上角的"运行组件"按钮预激活通道
    • 系统会自动保存配置并启动通道监听
    • 激活成功后会返回提示消息
  4. 现在可以直接在对应的远控通道平台中@智能体，发送消息开始对话

💡 通道预激活优势：无需在试验场发送消息即可激活通道，方便快速验证通道配置是否正确。

五、常见问题（FAQ）

Q1: 技能是如何获取和更新的？

A: 技能数据源直接通过后端接口读取容器内可用技能集合，点击"刷新"按钮即可动态获取最新列表。管理员在AgentX Server全局分配技能时，底层系统会自动创建软链接，用户只需勾选即可使用。

Q2: 多个用户同时使用同一个Nanobot节点会冲突吗？

A: 不会。Nanobot采用独创的双层沙盒隔离机制：

  • 配置层：所有请求共享读取节点配置
  • 执行层：每次请求生成唯一会话ID，创建专属子目录，记忆库、运行日志、生成产物全部读写于此，保证并发绝对安全

Q3: 执行过程中报错"自治任务执行超限，已强制停止"是什么原因？

A: 这是系统的无限循环熔断保护机制。当大模型因自身逻辑缺陷导致反复调用同一工具失败，触发 Max Autonomous Steps 阈值后，会强制中断Nanobot进程，防止工作流卡死。可适当调大阈值或优化Prompt。

Q4: 技能加载失败怎么办？

A: 如果初始化时Nanobot发现勾选的技能缺少环境依赖，会立即在节点层面抛出异常并阻断运行，Langflow画布节点会飘红提示："技能 [XXX] 加载失败，缺少依赖环境"。请联系管理员检查技能依赖配置。

Q5: 远控通道绑定后如何激活？

A: 配置并绑定远控通道后，点击组件右上角的"运行组件"按钮即可预激活通道：

  • 无需在试验场发送消息即可激活
  • 系统会保存配置并启动Gateway daemon线程监听WebSocket
  • 返回提示消息告知用户通道状态
  • 通道持续监听直到服务重启或切换通道