智能体

一、概述

智能体（AI Agent）是系统提供的一个强大的AI能力扩展模块，它通过灵活的配置机制，让您能够轻松构建出满足特定业务需求的AI助手。智能体模块具有两大核心特性：

1.1 系统插件

智能体可以调用系统提供的各类插件，实现多样化的功能扩展。这些插件涵盖了从数据操作到业务流程管理的各个方面，让AI助手能够真正参与到实际业务中。

主要插件类别：

插件类别	功能说明	典型应用场景
设计器脚本	管理应用中的脚本和代码模块	代码审查、脚本优化、自动化测试
设计器仪表盘	操作和管理数据可视化仪表盘	数据分析报告、图表生成、业务监控
设计器工作流	创建和管理BPMN业务流程	流程设计、审批管理、自动化流程
数据表操作	查询、统计、增删改数据记录	数据分析、报表生成、数据维护
搜索引擎	全局搜索应用内的各类模块	快速检索、内容发现、知识管理
其他工具	联网能力、HTML渲染、时间处理等	信息查询、页面生成、定时任务

1.2 MCP服务能力

智能体支持作为MCP（Model Context Protocol）服务对外提供，这意味着：

跨应用共享：可以将配置好的智能体通过API接口提供给其他应用使用
标准化接口：基于MCP协议，确保与各类AI应用的兼容性
灵活调用：外部系统可以通过API Key安全地调用智能体服务
集中管理：在一处配置的智能体能力，可以在多处使用

二、智能体配置架构

智能体的配置分为三个主要部分：

智能体配置
├── 智能体设置（基础配置）
│   ├── 基本信息（名称、标识、描述）
│   ├── 开场白设置
│   ├── 引导问题
│   └── 输入提示
│
├── 插件设置（功能配置）
│   ├── AI模型配置
│   ├── 模型提供方选择
│   └── 系统插件选择
│
└── MCP设置（服务配置）
    ├── MCP服务开关
    ├── 授权方式
    └── 服务配置（预览/生产环境）

三、快速配置智能体

3.1 步骤一：创建智能体

在左侧导航栏中，点击【智能体】进入智能体管理页面
点击页面右上角的【创建智能体】
系统会创建一个新的智能体配置入口

3.2 步骤二：基本信息配置

进入【智能体】选项卡，配置智能体的基础信息：

基本设置项

配置项	说明	示例	是否必填
名称	智能体的显示名称	"HR助手"、"数据分析师"	必填
标识符	智能体的唯一标识	hr_assistant	必填
图标	智能体的显示图标	上传PNG/JPG图片	可选
图标色	图标背景颜色	选择颜色或输入色值	可选
描述	智能体的功能说明	"协助处理人力资源相关事务"	推荐填写
输入提示词	用户输入框的提示文字	"请输入您的问题..."	可选

交互设置

开场白配置：

设置智能体的开场问候语
可以包含对功能的简要介绍
示例："您好！我是HR智能助手，可以帮您查询员工信息、处理考勤数据、生成人事报表。请问有什么可以帮您？"

引导性问题：

点击【+ 新增】添加常见问题
这些问题会在对话开始时展示，引导用户快速使用
示例问题：
- "查询本月的考勤统计"
- "生成部门人员花名册"
- "查看待审批的请假申请"

人设与回复要求：

定义智能体的角色定位和回复风格
示例："你是一个专业、友好的HR助手，擅长处理人力资源数据，回复时要准确、高效，使用简洁专业的语言。"

3.3 步骤三：插件配置

切换到【插件设置】选项卡，配置智能体的功能能力：

AI模型配置

配置项	说明	推荐设置
AI模型配置	选择提示词管理方式	根据需求选择
模型提供方	选择AI服务提供商	根据可用资源选择
语言模型	选择具体的模型版本	推荐使用最新版本
API Key	填写模型访问密钥	从服务商获取
API 地址	模型服务地址	通常自动填充

模型参数调优

Temperature（随机性）：

范围：0-1
越接近0，回复越确定和一致
越接近1，回复越有创造性
推荐值：
- 数据查询类：0.3-0.5（需要准确性）
- 创意生成类：0.7-0.9（需要多样性）

回复的最大Token数量：

控制单次回复的长度
推荐值：根据应用场景设置
- 简短回复：500-1000
- 详细解答：2000-4000

话题关联度（presence_penalty）：

范围：-2到2
正值：鼓励谈论新话题
负值：倾向于重复已有内容
推荐值：0（平衡）

频率关联度（frequency_penalty）：

范围：-2到2
正值：减少重复用词
推荐值：0（自然表达）

保留的对话轮次：

控制上下文记忆长度
推荐值：100轮（足够的上下文）

系统插件选择

点击【系统插件】区域的【添加】按钮，选择需要的功能插件：

设计器应用类插件：

插件名称	功能描述	适用场景
查询应用配置信息	获取应用基础配置	了解应用结构
读取Office文档内容	解析Word、Excel等	文档分析
读取仪表盘达式文档	读取可视化配置	仪表盘管理
查询应用脚本列表	列出所有脚本	代码管理
查询应用脚本内容	查看脚本详情	代码审查
创建脚本目录	组织脚本结构	项目管理

设计器仪表盘类插件：

插件名称	功能描述	适用场景
读取仪表盘文档	获取仪表盘配置	数据分析
查询应用仪表盘定义列表	列出所有仪表盘	资源管理
查询应用仪表盘卡片定义列表	获取卡片配置	组件管理
查询应用仪表盘卡片定义详情	查看卡片详情	深度分析
创建仪表盘模块	新建仪表盘	快速开发
保存仪表盘专业图表卡片	保存图表配置	配置持久化

设计器工作流类插件：

插件名称	功能描述	适用场景
创建BPMN流程模块	新建工作流	流程设计
创建BPMN流程定义	定义流程逻辑	业务建模
创建或更新BPMN节点详情	配置流程节点	节点编辑
删除BPMN节点	移除流程节点	流程优化
创建或更新BPMN流程流详情	配置连线逻辑	流程连接
删除BPMN流程流	删除连线	流程调整
查询应用BPMN流程定义列表	列出所有流程	流程管理
查询应用BPMN流程定义详情	查看流程详情	流程查看
更新BPMN流程定义启动设置	配置触发方式	流程部署

数据表操作类插件：

插件名称	功能描述	适用场景
查询应用数据表列表	获取所有数据表	数据库浏览
查询数据表结构定义	查看表结构	结构分析
查询数据表记录列表	按条件查询数据	数据检索
统计数据表记录数量	统计记录总数	数据统计
批量插入数据表记录	批量新增数据	数据导入
批量更新数据表记录	批量修改数据	数据更新
批量删除数据表记录	批量删除数据	数据清理
创建数据表筛选条件	构建查询条件	复杂查询

搜索引擎类插件：

插件名称	功能描述	适用场景
查询应用搜索引擎模块列表	列出搜索配置	搜索管理
查询应用搜索引擎数据记录	执行全局搜索	内容检索

其他工具类插件：

插件名称	功能描述	适用场景
联网能力	访问互联网资源	信息查询
代码执行器	执行JavaScript代码	数据处理
渲染HTML	生成可视化界面	页面展示
获取当前时间	获取系统时间	时间计算
获取当前用户	获取用户信息	权限控制
发送通知	发送系统消息	消息提醒

插件选择建议：

根据智能体的实际功能需求选择插件
避免添加不必要的插件，以提升响应速度
可以先从基础插件开始，后续根据需要逐步添加

3.4 步骤四：MCP服务配置

如果需要将智能体作为MCP服务对外提供，切换到【MCP设置】选项卡：

启用MCP服务

开启MCP服务开关：将"启用MCP服务"开关切换到开启状态
选择MCP授权方式：
- 应用API Key：使用应用级别的密钥
- 其他授权方式：根据系统支持选择
配置服务环境：

预览服务配置：

json

{
  "mcpServers": {
    "designer_ai_qgessolkhrl08": {
      "url": "https://uat2.informat.cn/web0/aiagent/preview/ap1y7bngtgqjd/designer_ai_qgessolkhrl08/event",
      "headers": {
        "X-INFORMAT-APIKEY": "<X-INFORMAT-APIKEY>"
      }
    }
  }
}

生产服务配置：

生产环境的配置格式类似，但URL会指向生产域名
API Key需要单独生成和管理

MCP服务使用说明

调用方式：

外部应用通过MCP协议连接到配置的URL
在请求头中携带X-INFORMAT-APIKEY进行身份验证
发送符合MCP协议的请求体
智能体处理后返回结果

安全建议：

妥善保管API Key，避免泄露
定期更换API密钥
监控API调用日志，及时发现异常
为不同的外部应用使用不同的API Key

四、智能体配置

4.1 功能定位

在配置智能体前，明确回答以下问题：

这个智能体主要解决什么问题？
目标用户是谁？
需要访问哪些数据？
需要执行哪些操作？

4.2 交互设计

开场白设计：

简洁明了地介绍功能
给出1-2个使用示例
设置友好的语气

引导问题设计：

覆盖主要使用场景
问题表述清晰具体
数量控制在3-5个

提示词优化：

清晰定义智能体角色
说明回复的格式要求
设置必要的限制和边界

4.3 插件选择

按需选择：

只添加必要的插件
避免功能冗余
考虑性能影响

组合使用：

数据查询 + 统计分析
工作流查询 + 节点编辑
表结构查询 + 数据操作

五、典型应用场景示例

场景1：数据分析助手

功能定位： 帮助用户查询和分析业务数据

插件配置：

查询应用数据表列表
查询数据表结构定义
查询数据表记录列表
统计数据表记录数量
创建数据表筛选条件

提示词示例： 你是一个专业的数据分析助手，擅长处理和分析业务数据。你可以：

查询数据表结构和内容
执行复杂的数据筛选和统计
生成数据分析报告

回复要求：

准确理解用户的查询需求
使用表格形式展示数据结果
提供数据洞察和建议
使用专业但易懂的语言

场景2：工作流管理助手

功能定位： 协助用户设计和管理业务流程

插件配置：

查询应用BPMN流程定义列表
查询应用BPMN流程定义详情
创建BPMN流程模块
创建或更新BPMN节点详情
创建或更新BPMN流程流详情

提示词示例：

你是一个业务流程管理专家，熟悉BPMN标准和工作流设计。你可以：

帮助用户设计业务流程
创建和编辑工作流节点
优化现有流程配置

回复要求：

以流程图的方式描述流程结构
给出节点配置的具体建议
考虑流程的合理性和效率
使用业务语言而非技术术语

场景3：应用配置助手

功能定位： 帮助开发者管理应用配置

插件配置：

查询应用配置信息
查询应用脚本列表
查询应用脚本内容
查询应用仪表盘定义列表
读取Office文档内容

提示词示例： 你是一个应用配置管理专家，帮助开发者管理和优化应用配置。你可以：

查看和分析应用配置结构
检查脚本代码和仪表盘配置
提供配置优化建议

回复要求：

准确识别配置问题
提供具体的修改建议
使用代码块展示配置示例
考虑最佳实践和性能优化

六、常见问题解答

Q1：智能体和普通AI对话的区别是什么？

A：智能体是功能增强版的AI助手：

普通AI对话：仅能进行文本对话，没有系统操作能力
智能体：可以通过插件调用系统功能，执行实际操作（如查询数据、创建流程等）

Q2：一个智能体可以添加多少个插件？

A：技术上没有数量限制，但建议：

保持在10-15个插件以内
只添加必要的插件
插件过多会影响响应速度和准确性

Q3：如何保证智能体的回复质量？

A：关键在于提示词设计和参数调优：

清晰定义智能体的角色和能力范围
提供详细的回复格式和质量要求
合理设置Temperature等参数
通过测试不断优化

Q4：MCP服务的应用场景有哪些？

A：典型场景包括：

跨应用共享AI能力
为第三方系统提供AI服务
构建AI服务市场
实现AI能力的集中管理和分发

Q5：智能体的对话历史会保存吗？

A：根据系统配置：

会话期间：对话历史保存在内存中
保留轮次：由"保留的对话轮次"参数控制
长期存储：需要查看系统的数据保留策略

智能体 ​

一、概述 ​

1.1 系统插件 ​

1.2 MCP服务能力 ​

二、智能体配置架构 ​

三、快速配置智能体 ​

3.1 步骤一：创建智能体 ​

3.2 步骤二：基本信息配置 ​

基本设置项 ​

交互设置 ​

3.3 步骤三：插件配置 ​

AI模型配置 ​

模型参数调优 ​

系统插件选择 ​

3.4 步骤四：MCP服务配置 ​

启用MCP服务 ​

MCP服务使用说明 ​

四、智能体配置 ​

4.1 功能定位 ​

4.2 交互设计 ​

4.3 插件选择 ​

五、典型应用场景示例 ​

场景1：数据分析助手 ​

场景2：工作流管理助手 ​

场景3：应用配置助手 ​

六、常见问题解答 ​

Q1：智能体和普通AI对话的区别是什么？ ​

Q2：一个智能体可以添加多少个插件？ ​

Q3：如何保证智能体的回复质量？ ​

Q4：MCP服务的应用场景有哪些？ ​

Q5：智能体的对话历史会保存吗？ ​

智能体

一、概述

1.1 系统插件

1.2 MCP服务能力

二、智能体配置架构

三、快速配置智能体

3.1 步骤一：创建智能体

3.2 步骤二：基本信息配置

基本设置项

交互设置

3.3 步骤三：插件配置

AI模型配置

模型参数调优

系统插件选择

3.4 步骤四：MCP服务配置

启用MCP服务

MCP服务使用说明

四、智能体配置

4.1 功能定位

4.2 交互设计

4.3 插件选择

五、典型应用场景示例

场景1：数据分析助手

场景2：工作流管理助手

场景3：应用配置助手

六、常见问题解答

Q1：智能体和普通AI对话的区别是什么？

Q2：一个智能体可以添加多少个插件？

Q3：如何保证智能体的回复质量？

Q4：MCP服务的应用场景有哪些？

Q5：智能体的对话历史会保存吗？