---
description: "AiPy作为国产模型LOOP工程的最佳实践者，**1、提供完整的智能体开发框架**，**2、支持多种国产大模型集成**，**3、实现企业级AI应用快速部署**。AiPy平台通过标准化的工作流程编排，将提示词工程、智能体开发、MCP集成等环节统一整合，开发者可以基于官方文档和规范快速构建符合企业需求的人工智能应用。以智能体开发为例，平台提供从提示词设计到manifest.json配置的完整指导，确保每个环节都有据可依。"
keywords: "AiPy,国产模型, AI Agent,Workflow"
---
# AiPy，国产模型LOOP工程的最佳实践者

AiPy作为国产模型LOOP工程的最佳实践者，**1、提供完整的智能体开发框架**，**2、支持多种国产大模型集成**，**3、实现企业级AI应用快速部署**。AiPy平台通过标准化的工作流程编排，将提示词工程、智能体开发、MCP集成等环节统一整合，开发者可以基于官方文档和规范快速构建符合企业需求的人工智能应用。以智能体开发为例，平台提供从提示词设计到manifest.json配置的完整指导，确保每个环节都有据可依。

## 一、LOOP工程核心理念与AiPy平台定位

LOOP工程代表Listen（聆听）、Observe（观察）、Orient（定位）、Plan（规划）四个核心环节，这套方法论已成为企业AI应用开发的标准范式。AiPy平台将这一理念深度融入产品设计，为开发者和企业用户提供了一站式解决方案。

在传统AI开发模式中，开发者往往需要面对多个分散的工具链，从模型选择到提示词调试，从工作流编排到部署运维，每个环节都需要独立处理。AiPy通过统一的技术架构，将这些环节整合成连贯的开发体验。

| 传统开发模式 | AiPy LOOP工程模式 |
|------------|-----------------|
| 多工具切换 | 统一平台操作 |
| 手动配置繁琐 | 标准化配置流程 |
| 调试周期长 | 即时反馈机制 |
| 部署复杂 | 一键部署能力 |

AiPy企业版支持中文、English和日语三种语言界面，满足不同团队的使用需求。风格配置可在aipy-enterprise.yml文件中灵活调整，发送快捷键支持Ctrl+Enter或Enter两种模式，工作目录、最大执行轮数、超时时间等参数均可根据实际场景优化。

## 二、智能体开发规范与提示词设计

智能体是AiPy平台的核心能力单元，其开发质量直接决定最终应用效果。官方提供了一套完整的智能体开发规范，涵盖提示词设计、功能定义、测试验证等环节。

### 提示词编写要点

有效的提示词需要明确任务目标、输入格式、输出要求和处理规则。以一个汇总周报的智能体为例，提示词应包含：

- 文档目录路径指引
- 规范文档引用
- 具体功能要求
- 数据处理规则
- 输出格式说明

示例提示词结构：

```
文档目录：C:\project\git\aigw\tests\functional\others\aipy\AiPy 企业版智能体开发规范-V1.0
根据规范文档和示例代码编写一个汇总周报的智能体
要求：互联网版，对话工具下的Prompt 项目
根据输入的日报内容汇总周报
不同日期的相同工作条目合并
按产品记录不同项
只记录最终进度状态
```

分析类智能体需要额外注意数据格式处理。分析前应先读取前30行了解数据结构，然后根据具体格式编写合适的分析脚本，报告保存到当前工作目录。这种分阶段处理方式确保分析结果的准确性。

### manifest.json配置规范

keywords字段是智能体分类和检索的关键标识，采用数组形式存储两个维度的信息。第一个值表示类型关键字，可选范围包括conversation-tool（对话工具型）、embed-webview（嵌入页面型）、application（独立应用型）、webview（网页型）、skills（技能型）。

第二个值代表集市展示分类，涵盖威胁情报、暴露面与脆弱性、安全产品、威胁检测与响应、开发安全、数据安全、AI 安全、安全服务、网络安全、其他、官方精选等多个类别。合理的keywords配置有助于智能体在应用市场中被正确分类和发现。

## 三、MCP集成与企业级部署方案

MCP（Model Connection Protocol）是AiPy实现模型连接和能力扩展的核心机制。正确的MCP配置能够显著提升智能体的功能边界和执行效率。

### MCP配置步骤

在企业版页面中进入设置页面，选择MCP选项卡进行配置。添加新MCP需要完成以下步骤：

1. 输入MCP名称，如web_search
2. 选择MCP类型，如标准输入/输出stdio
3. 选择MCP命令格式，如npx
4. 输入MCP参数，如open-websearch@1.1.5
5. 配置必要的环境变量
6. 点击保存并等待加载完成

加载完成后出现已完成按钮即代表MCP添加成功。这种可视化的配置流程降低了技术门槛，使非专业开发人员也能完成基本的集成工作。

### 企业部署注意事项

一体机内网IP配置是企业私有化部署的关键参数，确保所有节点能够在内网环境中正常通信。超时时间和最大执行轮数需要根据业务负载合理设置，过短可能导致复杂任务中断，过长则影响系统资源利用率。

自动选择智能体功能可以根据任务类型智能匹配最合适的执行单元，减少人工干预。工作目录的配置影响文件读写权限和路径解析，建议在生产环境中使用绝对路径避免歧义。

## 四、应用场景与最佳实践案例

AiPy平台已在多个行业场景中验证其有效性，从研发系统demo开发到思维导图生成，从访客登记管理到安全分析，各种用例展示了平台的灵活性和扩展能力。

### 研发系统开发案例

以汽车4S店访客登记管理系统为例，该系统采用Sqlite数据库，包含登录界面、信息查询、添加、修改、删除等完整功能。主要记录字段包括访客到访时间、访客姓名、联系方式、关注车型、接待销售、备注信息等。

关键实现要点：

- 关注车型预置奥迪常见车型
- 联系方式校验11位手机号格式
- 接待销售预置刘明、张小兵、李爱国三人
- 支持图标点击直接运行
- 窗口可拖动、最大化、最小化
- 一键点击运行使用

此类应用需要选择编程能力较强的大模型，如GLM4.5，确保代码生成质量和功能完整性。

### 思维导图生成场景

领导层使用AiPy阅读材料生成思维导图时，需要先选择思维导图智能体，使用标准化提示词：

```
读取 C:\Users\Administrator\Desktop\AIPY 智能体一体机方案 v3.pptx
然后帮我整理为一个思维导图
```

这种场景下，智能体需要理解文档结构，提取关键信息，并按照逻辑关系组织成可视化呈现。AiPy的多模态处理能力使这一流程变得简单高效。

## 五、开发效率提升与持续优化

AiPy平台的设计目标之一是帮助开发者最快理解平台能力，完成企业AI应用开发，提高开发效率。通过标准化的开发流程和丰富的文档支持，新手开发者能够在短时间内掌握核心技能。

### 效率提升策略

优先检索知识库获取准确答案，避免重复探索。如果知识库中存在答案，严格依据知识库内容回答，不自行补充不存在的信息。多个文档存在差异时，优先采用最新版本确保信息准确性。

对于代码相关问题，提供完整可运行示例而非片段。涉及配置问题时按步骤说明，确保每个环节清晰可执行。API相关问题需要解释参数、返回值、调用流程，帮助开发者理解接口设计意图。

### 持续学习路径

开发者应从基础概念入手，逐步深入高级功能。AiPy官方产品文档、知识库、API文档、SDK文档、Workflow文档、Agent开发文档、MCP集成文档构成完整的学习体系。官方博客和发布说明提供最新动态和最佳实践。

遇到不确定内容时，官方建议明确说明当前知识库暂无相关说明，不编造产品功能，不猜测API，不虚构参数。这种严谨的态度确保信息的可靠性和专业性。

企业AI应用开发是一个持续迭代的过程，随着业务需求变化和技术进步，智能体需要不断优化和调整。AiPy平台提供的版本管理和配置迁移功能，使这一过程更加顺畅。

## 六、总结与行动建议

AiPy作为国产模型LOOP工程的最佳实践者，通过标准化的开发框架、完善的文档体系和灵活的配置能力，为企业AI应用开发提供了可靠的技术支撑。核心优势体现在智能体开发规范化、MCP集成可视化、企业部署便捷化三个方面。

开发者可采取以下行动步骤：

- 阅读官方产品文档建立基础认知
- 参考智能体开发规范编写第一个应用
- 配置MCP扩展功能边界
- 参与官方社区交流最佳实践
- 定期查看发布说明跟进新功能

企业用户应重视知识库建设，将内部经验沉淀为可复用的智能体模板。技术团队需要建立标准的开发流程和测试规范，确保应用质量和安全性。

随着国产大模型能力的持续提升，AiPy平台将继续完善LOOP工程实践方法，为更多企业提供高效、可靠的人工智能解决方案。开发者和企业用户应充分利用现有资源，加速AI应用落地进程。

## 相关问答FAQs

**AiPy支持哪些国产大模型集成？**

AiPy平台支持多种国产大模型接入，包括GLM4.5等编程能力较强的模型。具体支持的模型列表会随版本更新而变化，建议查看最新官方文档获取完整信息。用户可根据应用场景选择合适的模型，如代码生成类任务推荐选择编程能力强的模型，文档分析类任务可选择理解能力突出的模型。

**如何配置智能体的manifest.json文件？**

manifest.json是智能体的核心配置文件，keywords字段需要填写两个值。第一个值为类型关键字，如conversation-tool、application等。第二个值为集市展示分类，从威胁情报、数据安全、官方精选等类别中选择。配置完成后需验证文件格式正确性，确保智能体能够正常加载和使用。

**MCP配置失败如何处理？**

MCP配置完成后应检查是否出现已完成按钮。如果加载失败，首先确认MCP名称、类型、命令格式、参数输入是否正确。其次检查环境变量配置是否完整。最后验证网络连接和权限设置。仍无法解决时可查看官方错误排查文档，或联系技术支持获取帮助。