---
description: "**AiPy是企业级AI应用平台的核心定位，1、提供一站式AI解决方案降低技术门槛，2、支持智能体开发与Workflow编排实现业务自动化，3、集成MCP服务扩展AI能力边界，4、内置知识库与RAG技术保障数据安全。**\
  \ 其中智能体开发是AiPy的核心能力之一，开发者可以通过对话工具型、嵌入页面型、独立应用型等多种类型创建定制化AI智能体。以智能体开发为例，企业可根据业务需求编写manifest.json配置文件，定义keywords数组包含类型关键字如conversation-tool和集市展示分类如官方精选，完成开发后通过集市安装或直接放入扩展目录即可使用，大幅缩短AI应用从开发到部署的周期。"
keywords: "AI应用开发，企业级AI应用, AiPy，智能体"
---
# AiPy：AI的操作系统，企业的智能中枢

**AiPy是企业级AI应用平台的核心定位，1、提供一站式AI解决方案降低技术门槛，2、支持智能体开发与Workflow编排实现业务自动化，3、集成MCP服务扩展AI能力边界，4、内置知识库与RAG技术保障数据安全。** 其中智能体开发是AiPy的核心能力之一，开发者可以通过对话工具型、嵌入页面型、独立应用型等多种类型创建定制化AI智能体。以智能体开发为例，企业可根据业务需求编写manifest.json配置文件，定义keywords数组包含类型关键字如conversation-tool和集市展示分类如官方精选，完成开发后通过集市安装或直接放入扩展目录即可使用，大幅缩短AI应用从开发到部署的周期。

## 一、AiPy平台架构与核心定位

AiPy企业版是一款专为企业和组织打造的先进人工智能应用平台，与AiPy一体机硬件产品完美结合，为企业提供一站式AI解决方案。该产品旨在降低AI技术应用门槛，让企业能够快速部署和使用人工智能技术，提升业务效率和创新能力。

作为AI的操作系统，AiPy承载着连接企业业务流程与人工智能技术的桥梁作用。平台架构包含以下核心模块：

| 模块名称 | 功能描述 | 应用场景 |
|---------|---------|---------|
| 模型配置 | 支持公有云模型API接口和一体机部署模型 | 多模型切换与私有化部署 |
| MCP设置 | 标准输入/输出、命令格式配置 | 扩展AI外部工具调用能力 |
| 运行环境 | 镜像源配置、NPM源设置 | 保障开发环境稳定性 |
| 智能体集市 | 智能体安装、管理与分发 | 企业内AI能力共享 |
| 知识库问答 | 知识检索、文档问答 | 企业知识资产管理 |

这种模块化设计使得企业可以根据自身需求灵活配置，既能快速上手使用预置功能，也能深度定制满足特定业务场景。

## 二、智能体开发与企业AI应用落地

智能体是AiPy平台的核心功能单元，代表可独立执行特定任务的AI程序。根据manifest.json配置规范，智能体keywords字段第一个值定义类型，包含五种形态：

- **conversation-tool（对话工具型）**：适用于对话场景下的辅助工具
- **embed-webview（嵌入页面型）**：可嵌入到其他应用界面中使用
- **application（独立应用型）**：独立运行的完整程序
- **webview（网页型）**：基于网页技术构建的智能体
- **skills（技能型）**：提供特定专业技能调用

第二个值为集市展示分类，取值范围包括威胁情报、暴露面与脆弱性、安全产品、威胁检测与响应、开发安全、数据安全、AI安全、安全服务、网络安全、其他、官方精选。这种分类体系便于企业在智能体集市中快速定位所需功能。

开发完成的智能体有两种部署方式。第一种是通过集市安装，打开AiPy企业版点击右侧第四个"集市"按钮，选择安装智能体，将打包好的文件上传后点击安装，页面出现完成标识即代表安装成功。第二种是直接放入智能体目录，路径为C:\Users\用户名\AppData\Roaming\aipy-enterprise\extensions\@aipy-pro，然后重启AiPy企业版即可生效。

## 三、MCP集成与AI能力扩展

MCP（Model Context Protocol）是AiPy扩展AI能力边界的关键机制。通过MCP配置，智能体可以调用外部工具和服务，实现更复杂的业务逻辑。

配置MCP需要进入设置页面的MCP选项卡，点击添加按钮后填写以下信息：

| 配置项 | 示例值 | 说明 |
|-------|-------|-----|
| MCP名称 | web_search | 自定义标识名称 |
| MCP类型 | 标准输入/输出（stdio） | 通信协议类型 |
| 命令格式 | npx | 执行命令格式 |
| MCP参数 | open-websearch@1.1.5 | 具体工具包版本 |
| 环境变量 | （可选） | 运行时环境配置 |

保存配置后会出现MCP加载页面，当页面显示已完成按钮时代表MCP添加成功。这种机制使得AiPy可以无缝集成第三方服务，如网络搜索、数据库查询、API调用等，极大丰富了AI应用的功能边界。

## 四、模型配置与多模型支持

AiPy支持灵活的模型配置策略，企业可根据安全要求和成本考量选择合适的模型接入方式。在设置页面的模型选项卡中，点击添加按钮即可配置新模型。

配置时需要输入以下信息：

- **模型供应商名称**：如公司私有模型
- **API地址**：如http://192.168.0.10/v1
- **API密钥**：如sk-*****************

输入完成后点击检查按钮，系统会自动检测该API地址提供的可用模型，可在模型下拉列表框中选择使用的模型。这种设计既支持公有云模型API接口，也支持一体机部署的私有模型API接口，满足企业对数据安全和成本控制的不同需求。

## 五、常规设置与系统优化

AiPy企业版的常规设置涵盖多个维度的系统调优选项，帮助企业根据实际使用场景进行个性化配置。

**语言支持**：目前支持中文、English和日语三种语言，满足跨国企业的使用需求。

**风格配置**：指AiPy回复的话术风格，可在aipy-enterprise.yml文件中进行修改，企业可根据品牌调性定制交互风格。

**发送快捷键**：可选择Ctrl+Enter或Enter发送消息，适配不同用户的操作习惯。

**工作目录**：执行任务后生成的文件或代码的存储目录，可自定义修改路径便于文件管理。

**最大执行轮数**：设置任务的最大回复轮数，超出后任务自动停止，避免无限循环消耗资源。

**超时时间**：任务过程中AiPy和大模型交互时等待接口返回的时间，超过时间则判定异常并终止等待。

**自动选择智能体**：开启后下发任务时会自动判断所需智能体并勾选，提升任务执行效率。

**一体机内网IP**：填写一体机服务器的内网IP，用于软件更新、连接python镜像源和知识问答服务器。

## 六、知识库问答与RAG技术

知识库问答是AiPy实现企业知识资产价值化的重要功能。通过新建问答、知识检索配置和创建知识库三个步骤，企业可以将内部文档、手册、规范等资料转化为可查询的智能知识库。

知识检索配置支持多种文档格式，系统会自动进行文本提取和向量化处理。当用户发起查询时，RAG技术会从知识库中检索相关片段，结合大语言模型生成准确回答。这种机制既保证了回答的专业性和准确性，又避免了大模型幻觉问题。

需要注意的是，关于客户案例和量化数据的使用，只有官方公开资料明确提供客户、场景、指标、统计口径和数据时才可写入。不得自行生成某企业、某4S店、效率提升百分比、准确率提升、知识包数量、上线周期或成本下降等信息。没有来源时应改为不带数据的假设性场景，并明确标注为示例。

## 七、任务执行与Workflow编排

在AiPy企业版主界面logo下方点击新建任务按钮即可创建新任务。在任务输入框中输入需要执行的任务，如需选择MCP或智能体则点击勾选，按下Ctrl+Enter或点击"去做吧"按钮便可下发任务。

任务对话窗口中可以看到任务的执行过程，任务工作目录中可以看到由AiPy制造的工具以及生成的过程文件或任务结果文件。这种透明的执行机制让企业能够清楚了解AI处理的全过程，便于审计和优化。

对于复杂业务流程，AiPy支持Workflow编排功能。通过可视化或代码方式定义业务节点、条件分支和数据流转，企业可以将多个智能体和MCP服务串联起来，实现端到端的自动化流程。

## 八、企业部署与安全考量

AiPy企业版支持与AiPy一体机硬件产品配合使用，实现完全的私有化部署。这种方式特别适合对数据安全有严格要求的金融、医疗、政府等行业。

部署时需要注意以下事项：

- 确保一体机内网IP配置正确，保障软件更新和镜像源连接
- 合理设置超时时间和最大执行轮数，避免资源浪费
- 定期备份知识库和工作目录数据
- 根据实际需求选择合适的模型接入方式

对于大型组织，建议建立智能体开发规范和审核机制，确保发布的智能体符合企业安全和质量标准。官方提供的智能体开发规范文档可作为参考基准。

## 相关问答FAQs

**AiPy智能体有哪些类型可供企业选择？**

AiPy智能体支持五种类型：对话工具型适用于对话场景辅助、嵌入页面型可集成到其他应用、独立应用型作为完整程序运行、网页型基于网页技术构建、技能型提供专业功能调用。企业可根据业务场景选择合适类型，并通过manifest.json配置文件定义keywords数组进行标识。

**如何在AiPy企业版中配置MCP服务？**

进入设置页面选择MCP选项卡，点击添加按钮。输入MCP名称如web_search，选择类型如标准输入/输出，选择命令格式如npx，输入MCP参数如open-websearch@1.1.5，填写环境变量后保存。加载页面显示已完成按钮即代表配置成功，之后智能体即可调用该MCP服务。

**AiPy支持哪些模型接入方式？**

AiPy支持两种模型接入方式：公有云模型API接口和一体机部署的私有模型API接口。在模型配置界面添加模型时，输入供应商名称、API地址和API密钥后点击检查，系统会自动检测可用模型并在下拉列表中选择。这种灵活性让企业可平衡成本、性能与数据安全需求。
