实践：智能体挂载技能与 MCP 工具

本篇以「会议助手」智能体为例，讲解蓝域（LanSphere）智能体如何挂载蓝信 MCP 工具与自定义技能：用户用自然语言提出需求，智能体自主决策调用查询日程、创建会议、发送私聊消息等工具完成任务。适合已了解工作流与对话流、希望构建自主任务执行能力的开发人员阅读。

场景与价值

约会议前翻日程、建会议后逐个发通知、会后整理纪要——这些事不复杂但琐碎。智能体与工作流的区别在于：工作流按固定流程执行，智能体则由大模型根据用户意图自主规划、调用工具。把蓝信的日程、会议、消息能力以 MCP 工具形式挂给智能体，再挂一个自定义「会议纪要」技能，用户一句话就能完成一连串操作。

你将搭建什么

一个「会议助手」智能体：帮用户查日程、创建会议、给参会人发蓝信通知，还能把会议记录整理成结构化纪要。最终发布到蓝信 AI 助理，终端用户在蓝信客户端「AI 助理市场」中直接对话使用。

准备工作

第一步：创建「会议纪要」代码技能

技能是可复用的能力单元，挂载到智能体后由大模型按用户意图自动决策调用时机。这里创建一个代码技能，把用户粘贴的会议记录整理为「结论摘要 + 待办事项」的结构化结果。

1. 进入「左侧菜单 → SKILL 管理 → 自定义技能」，点击「创建技能」。
2. 基础信息：名称填「会议纪要」（必填，不超过 30 字符，同一空间内唯一），描述选填（不超过 200 字符）。
3. 选择类型：代码技能（Python 代码片段，定义输入输出 schema）。

注意：技能类型创建后不可修改。

4. 配置输入参数（JSON Schema），示例：

{
  "type": "object",
  "properties": {
    "meeting_title": { "type": "string", "description": "会议标题" },
    "transcript": { "type": "string", "description": "会议讨论原文或要点记录" }
  },
  "required": ["transcript"]
}

5. 配置输出参数（JSON Schema），示例：

{
  "type": "object",
  "properties": {
    "summary": { "type": "string", "description": "会议结论摘要" },
    "action_items": {
      "type": "array",
      "items": { "type": "string" },
      "description": "待办事项列表"
    }
  }
}

6. 配置执行逻辑：编写 Python 代码片段，解析输入并返回与输出 schema 一致的结构，示例：

def main(meeting_title: str = "", transcript: str = "") -> dict:
    lines = [line.strip() for line in transcript.splitlines() if line.strip()]
    action_items = [line for line in lines if "待办" in line or "负责" in line]
    summary = lines[0] if lines else "无有效会议记录"
    if meeting_title:
        summary = f"{meeting_title}：{summary}"
    return {"summary": summary, "action_items": action_items}

提示：代码写法以页面提供的代码模板为准，确保返回值字段与输出 schema 对应。

7. 调试运行并保存：保存前必须至少成功调试一次（调试超时 30 秒），用一段真实会议记录验证输出结构后再保存。

第二步：创建智能体

1. 点击「新建项目」，应用类型选择「智能体」，填写名称（如「会议助手」）。
2. 进入「应用开发」页签，完成模型选择（可选用系统默认对话模型）。
3. 编写提示词。提示词规范智能体的应答规则，仅内部使用，终端用户不可见：

你是一名会议助手，帮助用户处理日程、会议与会议通知相关的事务。

## 能力范围
1. 查询日程：按用户指定的日期查询日程安排。
2. 创建会议：根据用户提供的主题、时间、参会人创建会议。
3. 发送通知：给指定参会人发送蓝信私聊消息。
4. 整理纪要：根据用户粘贴的会议记录生成结构化会议纪要。

## 执行规则
- 创建会议、发送通知等实际操作前，先向用户复述关键信息
  （主题、时间、参会人、消息内容），得到确认后再执行。
- 信息不足时主动追问，不要臆测日期、时间与人员。
- 用户说"今天""明天"等相对日期时，先换算为具体日期再调用工具。
- 工具调用失败时，向用户说明失败情况并建议重试，不要假装已完成。

## 输出格式
- 日程、会议列表分条展示，包含时间与主题。
- 操作完成后简要回执：完成了什么、关键信息是什么。
- 与会议、日程无关的请求，礼貌说明自己的能力边界。

第三步：挂载蓝信 MCP 工具

在「应用开发 → 工具配置」中，从 MCP 服务分类勾选蓝信 MCP 服务的以下工具：

挂载后，大模型会根据用户意图自动决策调用哪个工具、何时调用，无需在画布中编排固定顺序。

第四步：挂载「会议纪要」技能

在工具配置区的「技能」分类中勾选第一步创建的「会议纪要」技能。如智能体挂载了多个技能，可按需配置允许或禁止调用的技能，避免意图相近的技能互相干扰。

第五步：表单配置（可选）

如希望用户进入对话前先补充基础信息（例如默认参会范围、所在部门），可在表单配置中添加表单项。表单变量会自动替换提示词中的对应变量，减少每轮对话中的重复说明。按页面提示完成配置即可。

第六步：调试对话

在调试区进行三轮对话，观察模型如何决策调用工具：

第一轮：查日程。 用户：「帮我看看今天有什么安排？」——模型识别为查询意图，调用「查询日程」工具，把结果分条整理后返回。

第二轮：建会议。 用户：「明天下午 3 点约一个项目评审会，参会人张三、李四。」——模型先把「明天」换算为具体日期，复述会议主题、时间、参会人请用户确认；用户回复「确认」后，调用「创建会议」工具并回执结果。

第三轮：发通知。 用户：「给张三和李四发个消息，提醒他们明天评审会带上季度数据。」——模型调用「发送私聊消息」工具逐个发送，完成后回执发送情况。

三轮覆盖了「查询 → 确认后执行 → 批量操作」的典型决策路径。调试中重点关注：模型是否选对了工具、相对日期是否换算正确、敏感操作前是否先征求确认。

第七步：发布到蓝信 AI 助理

智能体支持发布到蓝信 AI 助理（需管理员及以上角色，且仅限本人创建的应用）：

1. 进入应用详情页「发布渠道」页签，选择「蓝信 AI 助理」。
2. 已绑定蓝信的账号，确认弹窗后直接发布；未绑定的，按弹窗引导跳转蓝信授权认证中心，扫码认证通过后自动执行发布。
3. 助理标题默认继承应用名称（不超过 10 字）、描述默认继承应用说明（不超过 20 字）。
4. 发布后系统自动在蓝信侧创建应用与机器人实例，上架蓝信客户端「AI 助理市场」。终端用户首次使用需完成数据授权，同意授权后方可对话。

调优与边界

上线后可在「数据看板」页签查看运行成功率、工具调用分布等指标，在「对话日志」页签对回答标记好评/差评并添加标注回复，持续优化。

扩展思路

• 关联知识库：把会议纪要模板、会议室使用规范等文件挂给智能体，回答更贴合单位实际；
• 工作流调用：把「每周例会提醒」做成定时工作流，在画布中添加「智能体」节点调用本智能体；
• 批量通知：使用蓝信 MCP 的「获取群成员」工具，实现按群批量发送通知；
• 工作流技能：已有成熟工作流时，可将其封装为工作流技能挂给智能体，复用既有流程。