智慧园区_AI服务开发指南_40页_1mb

智慧园区AI服务开发指南总结

核心内容概述

本文档介绍了华为智慧园区AI服务（CampusMate）及其集成方式，旨在帮助开发人员快速构建园区智能化应用。CampusMate是eCampusCore的一部分，结合ModelEngine，提供从数据处理、模型微调到AI应用部署的一站式工具链，以支持园区场景下的智能服务。

主要观点

• 智能化服务：CampusMate通过多个Agent（意图识别、数据主题、知识问答、设备控制和服务调用）提供全面的园区智能服务。
• 集成方式多样：支持三种集成方式，包括直接调用预置大模型、基于自有Agent框架调用CampusMate提供的Agent，以及基于园区一体机AI全栈进行开发。
• ModelEngine功能：ModelEngine提供数据使能、模型使能和应用使能，缩短AI应用开发周期，支持大模型训练、部署及RAG应用开发。
• API调用方式：提供多种API接口，如chat、completeChat和completeChatSync，支持文本推理、流式推理和非流式推理。

关键信息

1. 园区智能服务（CampusMate）

• 功能介绍：

  • 意图识别Agent：支持用户意图解析与智能路由。
  • 数据主题Agent：提供数据服务接口，支持自然语言查询。
  • 知识问答Agent：基于企业私域知识库，实现智能问答。
  • 设备控制Agent：支持自然语言指令解析与设备控制。
  • 服务调用Agent：实现工单创建与三方系统交互。

• 架构特点：

  • 南向依赖ModelEngine，支持模型使能、数据使能和应用使能。
  • 北向提供API，支持与PC端、移动APP端等智慧应用交互。

• 集成场景：

  • 场景一：直接调用园区一体机预置的大模型（DeepSeek），通过ModelEngine实现模型部署和版本管理。
  • 场景二：基于自有Agent框架调用或编排CampusMate提供的Agent，实现业务编排。
  • 场景三：使用园区一体机AI全栈开发智能应用，完成知识库创建、模型部署及业务编排。

2. ModelEngine

• 功能介绍：

  • 提供数据处理、知识生成、模型微调、部署及RAG应用开发的全流程工具链。
  • 支持Python和Java插件开发。

• 数据使能：

  • 提供数据清洗、数据评估、QA对生成、知识生成等能力。

• 模型使能：

  • 降低模型训练和推理门槛，支持多种模型调用。

• 应用使能：

  • 提供一站式开发、调试和部署能力，帮助快速构建高准确率的AI应用。

3. API接口

• chat接口：

  • 调用方式：POST
  • URI：/v1/chat/completions
  • 支持文本和流式推理，通过指定模型实例名称、消息列表和流式参数进行调用。

• completeChat接口：

  • 调用方式：POST
  • URI：/mate-service/v1/chat/completions
  • 支持流式输出，可用于知识问答、园区数据查询、安防报告生成等功能。

• completeChatSync接口：

  • 调用方式：POST
  • URI：/mate-service/v1/chat/completions/sync
  • 支持非流式输出，一次性返回完整结果，适用于需要全量响应的场景。

4. 附录

• 获取子系统ID和密钥：
  • 登录平台Portal，进入“子系统接入”页面，获取子系统ID和下载密钥。

集成示例

场景一：访问DeepSeek示例

• 接口路径：/open/rsder/v1-chat/completions
• 调用方式：POST
• 请求头：
  • Authorization: 接入授权的API密钥
  • Content-Type: application/json
• 请求体：
  • model: 指定使用的模型实例名称
  • messages: 包含对话消息的列表，每个消息对象包含role和content字段
• 响应示例：
  • 返回包含id、object、created、model、usage和choices等字段的JSON响应。

场景二：会议预定开发示例

• 前提条件：智能应用工作流中预置了会议交互节点，且应用已部署。
• 操作步骤：
  1. 修改工作流中的会议预定节点调用逻辑，使用CampusMate API。
  2. 调用接口/mate-service/v1/chat/completions/sync，设置chatMode为chat.Bot，scenario为skill。
  3. 发送用户输入，如“请帮忙预定3月8日下午2点的会议室”。
  4. 接收返回结果，验证预定是否成功。

场景三：基于ModelEngine开发智能应用案例

• 前提条件：
  • ModelEngine在向量知识库中安装了园区专属知识。
  • 部署了DeepSeek大模型。
• 操作步骤：
  1. 制作自定义插件，实现对CampusMate API的调用。
  2. 使用ModelEngine进行应用编排，调用自定义插件。
  3. 部署并测试应用，确保知识问答功能正常。

总结

本文档详细介绍了华为智慧园区AI服务的开发指南，涵盖CampusMate的核心功能、ModelEngine的工具链、多种集成场景以及相关API接口。开发人员可根据自身需求选择合适的集成方式，快速构建园区智能化应用。同时，文档提供了详细的API调用方法和示例，便于理解和实现。