《软件院_AI智能体开发实战》

《港口场景AI智能体应用开发实战》

主讲：韩迎娣

【课程背景】

港口装备制造企业正面临数智化转型的重要机遇期。软件院承担着将AI技术与港口装备深度融合的核心使命。根据前期调研，工程师团队对大模型应用开发（RAG/Agent/模型微调）需求占比达26%，是软件院最迫切的技能需求之一。

本课程聚焦港口垂直领域的专业开发挑战：专业术语多、标注数据稀缺、业务逻辑复杂、与运筹优化算法结合需求强。课程围绕这些核心难点，通过国产工具链的实战训练，帮助工程师从"会用AI工具"跨越到"会开发AI应用"。

【课程收益】

掌握LLM应用开发的核心架构设计方法（Agent、RAG、MCP协议）

熟练构建港口垂域RAG知识库系统，掌握向量数据库与召回调优技术

能够独立设计面向港口业务场景的AI智能体解决方案

掌握飞书开放平台API深度集成，实现智能体的企业级交付

完成一个可演示的港口业务Agent原型项目

【课程特色】够专业，内容前沿且正确；讲俗话，将复杂技术具象清晰有趣化；重互动，巧妙设计提升参与感；能落地，反复验证的方法及真实案例

【课程对象】

【课程时间】

总课时：6小时

时间分配：理论讲解90分钟 + 动手实验150分钟 + 项目实战90分钟 + 展示评审30分钟

【课程大纲】

一、LLM应用开发架构设计

1、Agent架构设计模式

单Agent架构：ReAct框架（推理-行动循环）、Function Calling机制

多Agent协作架构：任务分解→子Agent执行→结果汇总

MCP协议（Model Context Protocol）：智能体如何标准化地对接外部系统和工具

思考：不同场景适合哪种架构？

2、API调用实战

通义千问API快速上手：创建API Key、发送请求、处理响应

动手实验：用API实现一个"设备故障诊断"的单轮对话

常见坑：Token计费陷阱、流式输出处理、错误重试机制

3、架构设计工作坊

分组讨论：针对港口设备健康管理场景，设计Agent架构方案

二、RAG知识库实战

1、RAG技术架构与关键决策

RAG核心流程：文档处理、向量化、存储、检索、增强生成

关键决策点：Chunk策略选择、Embedding模型选择、向量数据库选型

港口垂域RAG难点：专业术语、设备手册格式多样、图纸理解

2、实操：构建港口设备知识库

实操1：文档处理与分块

任务：将一份《岸桥操作手册》PDF进行智能分块

要点：按语义分块 vs 固定长度分块的差异、标题层级保留

常见坑：表格被截断、图片上下文丢失

实操2：向量数据库搭建

任务：使用Milvus/FAISS搭建本地向量数据库

要点：Embedding模型选择（通义千问Embedding vs 开源模型）、索引类型选择

讲师带做：从零搭建，确保每个学员跑通

实验3：召回效果调优

任务：测试不同检索策略的召回效果

要点：Top-K设置、混合检索（向量+关键词）、重排序（Rerank）

进阶技巧：Query改写提升召回率、元数据过滤缩小检索范围

3、RAG效果评估与优化

如何评估RAG系统的质量：准确率、召回率、幻觉率

常见优化手段：知识库质量治理、提示词增强、多路召回融合

港口场景特殊挑战：设备型号更新快，知识库如何保持时效性

三、港口业务Agent设计

1、港口装备核心场景分析

设备健康管理：故障预测、维护建议、备件推荐

作业调度优化：任务分配、路径规划（与OR算法结合）

智能运维：巡检报告生成、工单处理、异常告警

安全监控：异常检测、风险评估、合规检查

2、Agent设计方法论

需求分析：从业务痛点到Agent能力定义

工具定义：Agent需要调用哪些外部工具和API

工作流编排：多步骤任务的流程设计

效果评估：如何衡量Agent的业务价值

3、项目实战——"AGV智能调度助手"

项目目标：基于扣子平台，设计一个能够理解港口AGV调度需求的智能助手

需求描述：

接收自然语言调度指令（如"请在A区3号泊位安排2台AGV转运集装箱"）

调用OR优化算法计算最优调度方案

支持多轮对话修改指令，提供执行状态反馈

技术架构：

接入层：扣子Bot + 飞书机器人

理解层：通义千问大模型 + 意图识别

规划层：MCP协议 + Tool Calling

执行层：OR求解器（模拟）+ 调度引擎

反馈层：执行状态 + 结果展示

实战步骤：

第1步（20分钟）：需求拆解与Agent架构设计

第2步（25分钟）：工作流搭建与工具对接（含模拟OR算法）

第3步（20分钟）：测试与调优（多轮对话、异常处理）

第4步（15分钟）：飞书集成与效果展示

四、飞书深度集成与交付

1、飞书开放平台API概览

消息卡片开发：交互式卡片设计、按钮回调、表单提交

Webhook机制：事件订阅、异步通知、数据同步

权限管理：应用权限配置、审批流程

2、动手实验：企业级智能体交付

实操1：开发交互式消息卡片

任务：为"港口设备助手"开发报修流程卡片

功能：选择设备类型 → 填写故障描述 → 提交工单 → 查看进度

实操2：Webhook回调与数据同步

任务：配置Webhook接收Agent事件通知

场景：Agent完成调度任务后，自动推送结果卡片到飞书群

常见坑：回调地址配置错误、签名验证失败、超时处理

3、灰度发布与运维

灰度发布策略：先小范围测试，再逐步扩大

监控与告警：关键指标设定、异常处理流程

迭代优化：根据反馈持续改进Agent