---
description: "**AiPy 通过智能体机制将零散提示词封装为可复用系统能力，1、提示词统一管理避免重复编写，2、智能体集市实现能力共享，3、MCP 集成扩展企业现有系统。**其中提示词统一管理是最核心的优势，传统\
  \ AI 使用中开发者需要反复编写相似提示词，每次任务都要重新描述需求、格式要求和输出规范。AiPy 允许将经过验证的优质提示词打包成智能体，通过 manifest.json\
  \ 配置文件定义能力边界和调用方式，后续使用时只需选择对应智能体即可自动加载预设提示词，大幅降低重复劳动并保证输出质量一致性。"
keywords: "AiPy,AI Agent, 智能体，企业级AI应用"
---
# 告别 prompt 流浪，AiPy把你的AI能力装进系统内核

**AiPy 通过智能体机制将零散提示词封装为可复用系统能力，1、提示词统一管理避免重复编写，2、智能体集市实现能力共享，3、MCP 集成扩展企业现有系统。**其中提示词统一管理是最核心的优势，传统 AI 使用中开发者需要反复编写相似提示词，每次任务都要重新描述需求、格式要求和输出规范。AiPy 允许将经过验证的优质提示词打包成智能体，通过 manifest.json 配置文件定义能力边界和调用方式，后续使用时只需选择对应智能体即可自动加载预设提示词，大幅降低重复劳动并保证输出质量一致性。

## 一、为什么需要把 Prompt 能力系统化

在 AI 应用开发实践中，大量团队面临提示词分散管理的困境。同一个业务场景下，不同开发者编写的提示词风格各异、质量参差不齐，导致相同任务产生不同输出结果。企业部署 AI 系统时，这种碎片化问题会严重影响工作效率和交付质量。

传统工作模式下，开发者需要：

| 环节 | 问题表现 |
|------|----------|
| 提示词编写 | 每次任务重新编写，缺乏标准化 |
| 知识沉淀 | 优质提示词难以复用和传承 |
| 能力调用 | 无法快速切换不同专业能力 |
| 系统集成 | 提示词与业务流程脱节 |

AiPy 作为 AI 操作系统，通过智能体架构解决了这些问题。智能体本质上是封装了特定能力的小型 AI 程序，包含预设提示词、工具调用逻辑和输出规范。开发者可以将常用场景的提示词打包成智能体，在企业内部形成可复用的能力资产库。

## 二、AiPy 智能体的核心架构

智能体在 AiPy 体系中是独立的能力单元，通过 manifest.json 文件定义其属性和行为。配置文件中 keywords 字段决定了智能体的类型和分类。

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

- conversation-tool：对话工具型，适用于问答和任务处理场景
- embed-webview：嵌入页面型，可嵌入外部网页界面
- application：独立应用型，可独立运行完整程序
- webview：网页型，提供 Web 界面交互
- skills：技能型，专注特定功能实现

**集市展示分类涵盖多个领域：**

威胁情报、暴露面与脆弱性、安全产品、威胁检测与响应、开发安全、数据安全、AI 安全、安全服务、网络安全、其他、官方精选。这种分类体系帮助企业快速定位所需能力，在智能体集市中按需安装使用。

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

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

## 三、提示词封装的最佳实践

将零散提示词转化为智能体能力需要遵循规范化的开发流程。以下是经过验证的提示词编写模板和优化技巧。

**提示词示例场景：周报汇总智能体**

```
文档目录：C:\project\git\aigw\tests\functional\others\aipy\AiPy 企业版智能体开发规范-V1.0

根据规范文档和示例代码编写一个汇总周报的智能体。

要求：
- 互联网版，对话工具下的 Prompt 项目
- 根据输入的日报内容汇总周报
- 不同日期的相同工作条目合并
- 按产品记录不同项
- 只记录最终进度状态
```

这个示例展示了如何将具体业务需求转化为可执行的智能体提示词。关键点在于明确输入格式、处理逻辑和输出标准，使智能体能够稳定执行预期任务。

**提示词优化技巧：**

使用 AiPy 做复杂任务时，建议优先采用问答模式让系统优化提示词，再切换任务模式下发执行。提示词被誉为 AI 时代的编程语言，是人和大模型交互的关键载体。提示词质量直接影响 AI 理解用户真实意图的能力，编写不当会导致输出效果显著下降。

分析类任务需注意：分析前先读取前 30 行了解数据格式，根据具体数据格式编写合适的分析脚本，报告保存到当前工作目录。这种规范化流程确保智能体能够正确处理各类数据源。

## 四、MCP 集成扩展企业能力边界

Model Context Protocol（MCP）是 AiPy 连接企业现有系统的关键技术。通过 MCP 配置，智能体可以调用外部 API、访问数据库、操作文件系统，实现 AI 能力与业务流程的深度融合。

**MCP 配置步骤：**

1. 在 AiPy 企业版页面右下角点击"设置"
2. 选择"MCP"选项卡
3. 点击添加按钮进入配置界面
4. 输入 MCP 名称（如 web_search）
5. 选择 MCP 类型（如标准输入/输出 stdio）
6. 选择 MCP 命令格式（如 npx）
7. 输入 MCP 参数（如 open-websearch@1.1.5）
8. 输入环境变量（如无则不修改）
9. 点击保存，等待加载完成显示"已完成"

配置成功后，智能体即可通过 MCP 调用外部服务。这种方式避免了将敏感数据直接传递给大模型，同时保持了 AI 能力的灵活扩展性。企业可以将内部 API、数据库查询、文件处理等操作封装为 MCP 服务，供多个智能体复用。

## 五、企业级部署与配置管理

AiPy 企业版提供了完整的配置管理体系，支持企业根据自身需求定制 AI 工作环境。常规设置涵盖语言、风格、快捷键、工作目录等核心参数。

**常规配置选项：**

| 配置项 | 说明 | 可选值 |
|--------|------|--------|
| 语言 | 界面显示语言 | 中文、English、日语 |
| 风格 | 回复话术风格 | 在 aipy-enterprise.yml 中配置 |
| 发送快捷键 | 消息发送方式 | Ctrl+Enter 或 Enter |
| 工作目录 | 生成文件存储路径 | 可自定义修改 |
| 最大执行轮数 | 任务回复上限 | 数值设定 |
| 超时时间 | 大模型接口等待时间 | 数值设定 |
| 自动选择智能体 | 任务智能体自动匹配 | 开启/关闭 |
| 一体机内网 IP | 服务器连接地址 | IP 地址 |

**自定义配置深度定制：**

logo 自定义：配置文件位置 C:\Users\用户名\.aipyapp\aipy-enterprise.yml，可修改基础信息、主页 logo 和软件 logo。

角色自定义：在 yml 配置文件中根据需求对风格进行增加或修改，适应不同部门的使用习惯。

推荐任务：对 AiPy 页面上的推荐任务进行自定义，引导用户快速启动常用场景。

模型配置支持公有云模型 API 接口和一体机部署的模型 API 接口。添加模型时需输入供应商名称、API 地址、API 密钥，点击检查按钮可检测该 API 地址提供的模型列表，在下拉框中选择使用的模型。

运行环境设置允许用户选择镜像源或输入一体机镜像源、第三方镜像源，同样支持 NPM 镜像源配置，确保企业内网环境下的稳定运行。

## 六、智能体开发完整流程

从零开始开发一个企业级智能体需要经历完整的工程化流程。以下是标准开发路径和关键环节。

**开发流程概览：**

1. 需求分析：明确智能体要解决的具体业务问题
2. 提示词设计：编写可复用的核心提示词模板
3. 工具集成：配置所需 MCP 服务和外部 API
4. 清单配置：编写 manifest.json 定义智能体属性
5. 项目构建：使用 npx @anthropic-ai/dxt pack 打包
6. 测试验证：在 AiPy 企业版中安装并测试功能
7. 部署发布：上传集市或直接部署到目标环境

**manifest.json 关键配置：**

keywords 数组第一个值为类型关键字，第二个值为集市展示分类。这种双层分类机制确保智能体既能被正确识别类型，又能在集市中按业务领域归类展示。

**项目构建命令：**

```bash
npx @anthropic-ai/dxt pack
```

构建完成后生成可部署的打包文件，支持跨环境安装使用。

## 七、任务执行与结果管理

在 AiPy 企业版中创建任务是使用智能体的主要方式。任务模式下，在主界面 logo 下方点击新建任务按钮创建新任务。

**任务执行流程：**

1. 在任务输入框中输入需要执行的任务描述
2. 如需选择 MCP 或智能体，点击勾选对应选项
3. 按下 Ctrl+Enter 或点击"去做吧"按钮下发任务
4. 在任务对话窗口查看任务执行过程
5. 在任务工作目录查看生成的工具、过程文件或任务结果文件

任务执行过程中，AiPy 会自动记录与模型的交互轮数，超出最大执行轮数后任务自动停止。超时时间设置确保任务不会因接口异常而无限等待，超过设定时间则返回异常状态。

工作目录是任务产出的集中存储位置，所有生成的代码、文档、数据文件都保存在此目录，便于后续查看、修改和版本管理。

## 八、知识库问答增强智能体能力

AiPy 企业版支持知识库问答功能，为智能体提供企业专属知识源。新建问答时可配置知识检索参数，创建知识库上传企业文档资料。

知识检索配置允许设定检索策略、相似度阈值、返回数量等参数，确保智能体在回答时优先参考企业知识库内容。这种方式特别适合客服问答、内部培训、技术支持等场景，保证输出内容符合企业规范和最新政策。

创建知识库时需上传结构化文档，系统会自动建立索引和向量表示。后续问答时智能体会先检索相关知识片段，再结合大模型能力生成准确回答。

## 九、实际应用案例参考

研发场景中使用 AiPy 自动开发系统 demo 时，需要选择编程能力较强的大模型如 GLM4.5。提示词应明确描述业务需求、数据结构、功能模块和界面要求。

**车辆管理系统示例需求：**

- 采用 Sqlite 数据库
- 包含登录界面、信息查询、添加、修改、删除功能
- 记录访客到访时间、姓名、联系方式、关注车型、接待销售、备注信息
- 关注车型预置常见车型
- 联系方式校验 11 位手机号格式
- 接待销售预置具体人员姓名
- 支持点击图标直接打开运行
- 窗口可拖动、最大化、最小化
- 做好后可一键点击运行使用

这类示例展示了如何将具体业务需求转化为可执行的智能体任务，关键在于描述清晰、约束明确、验收标准具体。

思维导图生成场景同样适用智能体模式。领导使用 AiPy 阅读材料生成思维导图时，选择思维导图智能体，输入材料路径和整理要求，智能体自动提取关键信息并构建层次结构。

## 十、总结与行动建议

将 AI 能力从分散的提示词升级为系统化智能体，是企业 AI 应用成熟的标志。AiPy 通过智能体架构、MCP 集成和配置管理体系，为企业提供了一站式 AI 能力封装和部署方案。

**核心收益总结：**

提示词统一管理与复用减少重复劳动，智能体集市实现能力共享与快速部署，MCP 集成扩展企业现有系统连接能力，配置管理支持企业级定制化需求。

**行动建议：**

梳理现有业务场景中重复使用的提示词，优先封装为智能体。建立企业内部的智能体开发规范，统一提示词编写标准和质量要求。配置 MCP 服务连接核心业务系统，实现 AI 能力与数据流的无缝集成。定期在智能体集市查看官方更新和最佳实践，持续优化企业 AI 能力库。

---

## 相关问答 FAQs

**AiPy 智能体与传统提示词有什么区别？**

AiPy 智能体是封装了提示词、工具调用逻辑和输出规范的完整能力单元，通过 manifest.json 配置文件定义属性，支持在集市中安装和跨环境部署。传统提示词是零散的文本指令，每次使用需重新编写，缺乏版本管理和复用机制。智能体模式将提示词工程化，形成可维护、可测试、可共享的企业资产。

**如何在 AiPy 企业版中安装自定义智能体？**

有两种安装方式。第一种通过集市按钮，点击右侧第四个"集市"按钮，选择安装智能体，上传打包好的文件后点击安装，页面显示完成即代表成功。第二种直接放入智能体目录 C:\Users\用户名\AppData\Roaming\aipy-enterprise\extensions\@aipy-pro，然后重启 AiPy 企业版即可加载新智能体。

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

检查 MCP 名称是否唯一，类型选择是否正确（stdio 或其他支持类型），命令格式与参数是否匹配（如 npx 对应 npm 包名），环境变量是否完整。保存后观察加载页面是否出现"已完成"按钮，未出现则查看日志输出查找具体错误信息。确保网络环境可访问所需镜像源，内网环境需配置一体机内网 IP 和镜像源地址。