DeepSeek智慧园区产业及办公园区一体机方案开发指南总结
概述
本文档描述了DeepSeek智慧园区产业及办公园区一体机方案中，eCampsCore产品中的园区智能服务（CampusMate）的能力以及如何开发使用。主要面向智慧园区应用的开发人员，要求了解智慧园区业务场景，具备二次集成开发能力和大模型领域AI Agent开发基础知识。
什么是园区智能服务
园区智能服务（CampusMate）是eCampusCore针对园区场景推出的新服务，面向园区场景提供一系列智能化服务，将华为在200+园区项目中沉淀的行业知识与AI大模型深度融合。通过多个Agent提供不同的智能服务，如意图识别、数据主题、知识问答、设备控制和服务调用Agent。园区智能服务南向依赖于ModelEngine，北向提供API与PC端和移动APP端等多种形态的智慧应用进行交互。
功能介绍
- 意图识别Agent：用户意图解析与智能路由，精准识别用户意图类别，实现动态路由决策。
- 数据主题Agent：数据服务智能接口网关，基于园区数据中台构建，开放主题库与专题库，实现自然语言查询。
- 知识问答Agent：提供基于企业私域知识库的问答检索增强能力。
- 设备控制Agent：多类设备交互控制中枢，实现安防/通行/楼宇自控等设备的自然语言指令引擎的解析和自动化执行。
- 服务调用Agent：打通园区周边后台系统，实现自然语言对话转标准化工单，以及三方系统的自然语言交互实现。
什么是ModelEngine
ModelEngine提供从数据处理、知识生成，到模型微调和部署，以及RAG应用开发的AI训推全流程工具链，用于缩短从数据到模型、数据到AI应用的落地周期。
- 数据使能：提供文本、图像、文档等各类型数据处理的工具链。
- 模型使能：面向模型微调和模型推理的工具链。
- 应用使能：为AI应用提供一站式开发、调试和部署的工具。
园区智能服务集成场景
CampusMate提供多种集成方式，以满足用户开发诉求。
- 场景一：伙伴直接使用园区一体机中预置的大模型：伙伴基于自有全套框架构建智能应用，通过接口调用一体机中大模型（deepseek）。
- 场景二：伙伴基于自有Agent框架调用或编排园区智能服务提供的Agent：伙伴基于自有全套框架构建智能应用，可选用部分园区方案提供的架构、组件和工具整合为融合架构进行业务编排。
- 场景三：基于园区一体机AI全栈开发智能应用：伙伴完全基于园区方案提供的架构、组件和工具，使用ModelEngine和CampusMate能力完成知识库创建、模型部署及业务编排。
场景一：伙伴直接使用园区一体机中预置的
伙伴应用可直接通过API访问预置大模型（deepseek），使用ModelEngine提供的API与大模型进行交互。提供接口调用方式和代码示例，包括基于Python脚本访问大模型和通过OpenAI SDK访问大模型。
场景二：伙伴基于自有Agent框架调用或编排园区智能服务提供的Agent
使用自有编排工具，基于CampusMate和ModelEngine能力，实现业务编排。
- 直接使用CampusMate的Agent能力：通过API，直接使用CampusMate和ModelEngine提供的能力，完成业务编排。
- 基于CampusMate做意图识别和业务分发：使用自有的编排工具，开发新的Agent，并通过CampusMate实现多Agent分流。
- 会议预定开发示例：通过CampusMate提供的服务Agent实现预定会议。
- 产业分析开发示例：用户可以与CampusMate进行对话式知识问答，根据用户输入的意图流转到对应伙伴Agent进行专业知识问题。
场景三：基于园区一体机AI全栈开发智能应用
使用ModelEngine作为大模型和知识库构建工具，端到端完成智能应用工作流的开发和编排。
- 基于ModelEngine开发智能应用案例：在工作流编排中调用CampusMate提供的知识问答Agent能力访问园区专属知识库。
- 插件制作：使用ModelEngine的自定义插件能力，制作一个调用CampusMate API的插件，完成对CampusMate知识问答Agent调用。
- 应用编排：使用自定义插件编排工作流，实现知识问答的调用。
- 结果验证：测试知识问答结果。
API参考
- chat：调用方法为POST，URI为/v1/chat/completions，用于对话响应。
- completeChat：基于预置Agent和自定义Agent的对话接口，对话结果输出方式为流式。
- completeChatSync：基于预置Agent和自定义Agent的对话接口，对话结果输出方式为非流式，一次性全量返回。
获取子系统id和密钥
通过登录平台Portal，选择“平台服务>联接>子系统接入”，进入子系统接入页面，依次选择“子系统管理>子系统”，找到对应子系统，在子系统编码列，获取子系统id。单击操作列下“密钥”，单击“下载密钥”，下载请求密钥的txt文件。
