百数应用助手智能体

• 百数应用助手智能体
  • 智能体功能说明
  • 设计流程
  • 智能体开发
    • 1.新建百数MCP插件
    • 2.设计工作流
      • 设计思路
      • 工作流开发步骤
    • 3.设计智能体，挂载插件和工作流
    • 4.智能体调试和发布
  • 智能体助手开发
  • 在平台中使用智能体

智能体功能说明

搭建面向百数表单场景的自然语言智能体，用户在百数前端打开表单页面后，直接用自然语言指令，就能完成表单结构查看、数据查询、新增、编辑等操作，无需手动填写表单 ID、应用 ID 等参数，降低百数平台的数据操作门槛。

本示例仅演示智能体搭配百数 MCP 插件的基础用法，更多高阶能力可在此基础上持续深化拓展。

设计流程

用户打开平台表单并发起提问，智能体通过工作流读取页面环境信息；环境信息送入大模型后，大模型根据语义自动调用百数三方 MCP 工具，执行表单数据操作，最后将结果整理为自然语言返回给用户。

智能体开发

1.新建百数MCP插件

进入百数AI模式>>智能体开发>>资源库，新建三方MCP插件，详情参考：创建百数三方MCP插件示例。

百数MCP服务连接方式如下：

{
  "mcpServers": {
    "mcp_contact": {
      "type": "http",
      "url": "https://域名/mcp_contact",
      "headers": {
        "X-Api-Key": "{YOUR_APIKEY}"
      },
      "disabled": false
    },
    "mcp_form": {
      "type": "http",
      "url": "https://域名/mcp_form",
      "headers": {
        "X-Api-Key": "{YOUR_APIKEY}"
      },
      "disabled": false
    },
    "mcp_platform": {
      "type": "http",
      "url": "https://域名/mcp_platform",
      "headers": {
        "X-Api-Key": "{YOUR_APIKEY}"
      },
      "disabled": false
    }
  }
}

YOUR_APIKEY在开放平台>>api密钥中获取。

2.设计工作流

设计思路

百数 MCP 的各个工具（查询表单、新增数据等）都运行在服务侧，只能接收你显式传入的 表单ID、应用ID 参数。当用户在百数前端打开某张表单时，表单 ID、应用 ID 属于浏览器前端上下文，MCP 服务无法自动感知当前打开的是哪一个表单，必须由外部把环境变量读出来。

故设计一个工作流，来读取百数前端页面的实时环境信息：表单 ID、应用 ID、当前登录用户信息。

工作流开发步骤

1）新建自定义插件，实现获取用户环境变量功能。

入口：百数AI模式>>智能体开发>>资源库>>+资源，新建插件。

自定义插件的设计步骤可参考文档：创建自定义MCP类型插件示例。

工具代码如下：

import bmcp
import os
import json

# 具体字段类型和使用方式请参考MCP API文档

def get_env_vars(args: Args) -> Output:
    # args.params内容为MCP配置的入参
    params = args.params
    # 获取系统固定变量值请使用如下方式
    # envkey = os.getenv("ENV_KEY")  ENV_KEY为你需要获取的系统变量名
    env = {}
    # 字符串类型的系统变量
    env["appId"] = os.getenv("appId")
    env["entryId"] = os.getenv("entryId")
    env["appName"] = os.getenv("appName")
    env["entryName"] = os.getenv("entryName")
    env["agentName"] = os.getenv("agentName")
    # JSON 结构的系统变量
    env["corp"] = json.loads(os.getenv("corp")) if os.getenv("corp") else None
    env["user"] = json.loads(os.getenv("user")) if os.getenv("user") else None
    result = env
    return Output(result)

输入参数：无

输出参数：

参数名称	参数描述	参数类型
agentName	agentName	String
entryName	entryName	String
corp	corp	String
user	user	String
appId	appId	String
appName	appName	String
entryId	entryId	String

2）新建工作流，添加上个步骤新建的插件

入口：百数AI模式>>智能体开发>>资源库>>+资源，新建工作流。可参考文档：工作流。

新增插件节点，添加上个步骤新建的插件，节点输出为插件的输出参数。

结束节点，范回变量：设置返回上个节点的输出。

3）工作流设计完成后，发布

3.设计智能体，挂载插件和工作流

入口：百数AI模式 >> 智能体开发 >> 工作控件 >> 智能体 >> +新建，新建智能体。

1）添加设计好的插件和工作流。

2）提示词设计。

参考：

执行规则：
1. 用户提问时，优先调用getenv工作流获取表单ID、应用ID、用户等环境信息。
2. 根据获取到的环境信息，调用对应的百数MCP工具执行表单相关操作。

你拥有百数MCP插件能力，可以操作百数平台表单。
- 用户打开百数表单页面后，可使用自然语言查询账号信息、读取表单结构、查询表单数据列表、查看单条数据详情、新增表单数据、编辑表单字段。
- 必须优先执行getenv获取页面环境信息，缺少表单ID、应用ID时，提示用户【请先打开表单页面】。
- 依据用户自然语言语义自动选择MCP工具，自动填充表单ID、应用ID等入参，不要编造表单数据。
- 工具返回结果后，整理成简洁易懂的自然语言回答用户。

4.智能体调试和发布

在调试区域，和智能体对话，验证智能体功能。

验证完成后发布，发布成功后可供平台使用。

智能体助手开发

智能体助手是连接智能体和低代码平台的通道，将智能体配置在智能体助手中，即可在低代码平台使用。

入口：百数AI模式 >> 设置>> 新建智能体助手，选择智能体，完成相关参数配置，配置流程可参考文档：设置智能体助手。

在平台中使用智能体

智能体助手配置在AI体验应用下，进入此应用，打开AI模式，选择智能体助手。

验证智能体效果：

场景一：获取当前表单的数据信息，如获取学生表中名字为张三的同学的信息。

场景二：增加非当前表的数据，如当前在天气表，新增一条名字为 罗宋汤 学生的信息到学生表。

智能体会根据语义自动匹配到对应的表单，新增数据到该表单中。