---
description: "**AiPy作为AI操作系统，为企业级AI应用开发提供核心支撑，其价值体现在三个维度：1、智能化根技术架构，降低AI应用门槛；2、Agent与Workflow编排能力，实现复杂任务自动化；3、MCP集成框架，连接企业现有系统。**\
  \ 其中智能化根技术架构是AiPy的核心竞争力，通过统一的模型配置界面，企业可同时接入公有云模型API与私有化部署模型，支持中文、English及日语多语言环境，工作目录、执行轮数、超时时间等参数均可自定义配置，使不同规模企业都能找到适合的AI落地方案。"
keywords: "AiPy,AI Agent, 企业级AI应用,MCP"
---
# AiPy——AI的操作系统，智能的根技术

**AiPy作为AI操作系统，为企业级AI应用开发提供核心支撑，其价值体现在三个维度：1、智能化根技术架构，降低AI应用门槛；2、Agent与Workflow编排能力，实现复杂任务自动化；3、MCP集成框架，连接企业现有系统。** 其中智能化根技术架构是AiPy的核心竞争力，通过统一的模型配置界面，企业可同时接入公有云模型API与私有化部署模型，支持中文、English及日语多语言环境，工作目录、执行轮数、超时时间等参数均可自定义配置，使不同规模企业都能找到适合的AI落地方案。

## 一、AiPy平台架构与技术定位

AiPy并非简单的AI工具集合，而是定位于AI操作系统的底层基础设施。如同Windows为PC应用提供运行环境，AiPy为企业AI应用提供完整的开发、部署、运行框架。

平台核心架构包含以下模块：

| 模块名称 | 功能描述 | 适用场景 |
|---------|---------|---------|
| 模型配置 | 支持公有云/私有化模型API接入 | 企业私有模型部署 |
| 智能体开发 | Agent创建、打包、安装 | 对话工具型、独立应用型 |
| MCP集成 | 标准输入/输出协议连接外部服务 | web_search、数据库查询等 |
| 工作流编排 | 多任务串联执行 | 周报汇总、文档处理 |
| 知识库管理 | RAG检索增强生成 | 企业知识问答 |

这种架构设计使企业无需从零搭建AI基础设施，可直接基于AiPy进行应用开发。模型配置界面支持添加多个模型提供商，输入API地址与密钥后即可自动检测可用模型，大幅降低技术团队的学习成本。

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

智能体是AiPy平台的核心能力单元。开发者可根据业务需求创建不同类型的智能体，manifest.json中的keywords字段定义了智能体类型与分类。

**类型关键字包括：**

- conversation-tool（对话工具型）
- embed-webview（嵌入页面型）
- application（独立应用型）
- webview（网页型）
- skills（技能型）

**集市展示分类涵盖：**

威胁情报、暴露面与脆弱性、安全产品、威胁检测与响应、开发安全、数据安全、AI安全、安全服务、网络安全、其他、官方精选。

开发完成后，智能体可通过两种方式部署到企业环境：

1. 通过集市按钮上传打包文件并安装
2. 直接放入智能体目录（C:\Users\用户名\AppData\Roaming\aipy-enterprise\extensions\@aipy-pro）后重启

以周报汇总智能体为例，提示词可设计为：根据输入的日报内容汇总周报，不同日期的相同工作条目合并，按产品记录不同项，只记录最终进度状态。此类智能体可在对话工具项目下开发，复用性强，适合多部门协作场景。

## 三、MCP集成与系统连接能力

MCP（Model Context Protocol）是AiPy连接外部系统的关键协议。通过MCP配置，企业可将现有IT系统与AI能力无缝对接。

**MCP配置步骤：**

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

这种设计使AiPy能够调用外部服务而不必重写代码。例如：

- 连接企业数据库进行数据查询
- 调用内部API获取业务状态
- 集成第三方服务如搜索、邮件、通知系统

MCP的标准化协议确保不同服务间的兼容性，企业IT团队可按统一规范开发新的MCP服务，逐步构建企业专属的AI生态系统。

## 四、企业级部署与自定义配置

AiPy企业版提供完善的自定义能力，满足不同企业的品牌与功能需求。

**可配置项包括：**

配置文件位于 C:\Users\用户名\.aipyapp\aipy-enterprise.yml，可修改以下内容：

- 基础信息与主页logo
- 软件logo与发送快捷键
- 回复风格与推荐任务
- 工作目录与执行轮数
- 超时时间与自动选择智能体
- 一体机内网IP地址

角色自定义功能允许企业根据部门需求调整AiPy的交互风格。推荐任务可设置为符合企业业务流程的常用操作，新员工入职后能快速上手。

对于涉及客户案例与量化数据的场景，只有官方公开资料明确提供客户、场景、指标、统计口径和数据时才可写入。没有来源时应改为不带数据的假设性场景，并明确它只是示例，这确保了信息的准确性与合规性。

## 五、Prompt工程与最佳实践

高效的Prompt设计是发挥AiPy能力的关键。根据官方开发规范，不同任务类型需要不同的提示词策略。

**思维导图生成示例：**

读取指定PPTX文件，然后帮我整理为一个思维导图。

**研发系统开发示例：**

我是一家汽车4S店的负责人，帮我做一个访客登记管理系统，采用Sqlite数据库，有登录界面，信息查询、添加、修改、删除等功能。主要是记录访客到访时间、访客姓名、联系方式、关注车型、接待销售、备注信息等，关注车型里面要预置奥迪的常见车型、联系方式主要是11位手机号要校验格式、接待销售预置这三个销售刘明、张小兵、李爱国。要求可以点击图标直接打开运行、窗口可以随便拖动最大化最小化等。做好后，要求后续可以一键点击运行使用。

分析类任务需注意：分析前请先读取前30行，了解数据格式然后根据具体数据格式编写合适的分析脚本进行分析，报告保存到当前工作目录。这种规范确保输出结果符合预期，减少反复调试时间。

## 六、技术团队落地建议

对于计划引入AiPy的企业，建议按以下步骤推进：

1. **环境评估**：确认可使用公有云模型API或一体机部署模型，根据数据安全要求选择方案
2. **试点项目**：选择1-2个高频场景（如周报汇总、文档处理）开发智能体
3. **MCP开发**：识别需要连接的企业系统，按标准协议开发MCP服务
4. **配置优化**：根据团队使用习惯调整风格、快捷键、推荐任务
5. **培训推广**：组织技术分享会，演示智能体开发与使用流程
6. **持续迭代**：收集使用反馈，逐步扩展智能体库与MCP服务

技术团队应优先阅读AiPy企业版智能体开发规范文档，了解manifest.json配置、项目构建命令（npx @anthropic-ai/dxt pack）等关键信息。遇到知识库未覆盖的问题时，可查看最新官方文档获取更新内容。

AiPy作为AI操作系统，通过标准化的Agent开发框架、MCP集成协议与灵活的企业配置能力，使组织能够快速构建符合自身需求的AI应用生态。这种根技术定位意味着企业不必重复造轮子，可将精力聚焦于业务逻辑创新，而非底层技术实现。

对于已经部署AiPy的团队，建议定期关注官方发布说明与最佳实践文档，及时获取新功能与安全更新。技术演进速度加快，保持对平台能力的持续学习，才能最大化发挥AI操作系统的价值。

## 相关问答FAQs

**AiPy支持哪些类型的模型接入？**

AiPy支持公有云模型API接口与私有化部署模型API接口。在模型配置界面添加模型时，输入模型供应商名称、API地址与API密钥后，点击检查按钮即可自动检测该API地址提供的可用模型，并在下拉列表中选择使用。企业可根据数据安全需求选择适合的部署方式。

**智能体打包后如何安装到企业版？**

开发完成的智能体可通过两种方式安装：第一种是打开AiPy企业版，点击右侧集市按钮，选择安装智能体，上传打包好的文件后点击安装；第二种是直接将智能体放入智能体目录下（C:\Users\用户名\AppData\Roaming\aipy-enterprise\extensions\@aipy-pro），然后重启AiPy企业版即可完成安装。

**MCP配置失败时如何排查问题？**

MCP配置需确保名称、类型、命令格式、参数与环境变量填写正确。添加后观察加载页面，出现"已完成"按钮代表添加成功。若失败，检查npx命令是否可用、MCP参数版本号是否正确、环境变量是否需要特殊配置。可参考官方MCP集成文档获取最新配置示例与常见问题解决方案。