--- description: "**1、AiPy是企业级AI操作系统，将分散的AI工具整合到统一平台。**2、支持智能体开发、MCP集成、Workflow编排等核心功能。3、提供模型配置、知识库管理、多模态处理等一站式解决方案。**其中智能体开发功能最为关键**，开发者可以通过manifest.json配置文件定义智能体类型，选择conversation-tool对话工具型、embed-webview嵌入页面型、application独立应用型等多种类型，再通过集市安装或直接放入extensions目录完成部署，使企业能够快速构建专属AI应用。" keywords: "AiPy,AI Agent, 智能体，企业级AI应用" --- # 你的AI散落一地？AiPy把它们装进一个操作系统 **1、AiPy是企业级AI操作系统，将分散的AI工具整合到统一平台。**2、支持智能体开发、MCP集成、Workflow编排等核心功能。3、提供模型配置、知识库管理、多模态处理等一站式解决方案。**其中智能体开发功能最为关键**，开发者可以通过manifest.json配置文件定义智能体类型，选择conversation-tool对话工具型、embed-webview嵌入页面型、application独立应用型等多种类型，再通过集市安装或直接放入extensions目录完成部署，使企业能够快速构建专属AI应用。 ## 一、企业AI应用现状与痛点分析 当前企业在AI应用开发过程中面临诸多挑战。大多数企业使用的AI工具分散在不同平台，导致工作流程割裂、数据无法互通、管理成本高昂。开发人员需要在多个系统间切换，从模型配置到智能体开发，从知识库管理到API集成，每个环节都涉及不同的工具和流程。 这种分散状态带来三个核心问题。**第一是效率低下**，开发人员需要花费大量时间在不同平台间协调工作。**第二是标准不统一**，各团队采用的技术方案各异，导致后期维护困难。**第三是安全风险**，分散的系统难以进行统一的安全管控和权限管理。 AiPy作为AI操作系统，正是为了解决这些问题而设计。它将所有AI相关功能整合到一个统一平台，提供从模型配置、智能体开发、MCP集成到知识库管理的完整解决方案。企业只需在一个系统中完成所有AI应用的开发和部署，大幅降低技术门槛和运维成本。 ## 二、AiPy核心功能架构详解 AiPy企业版的产品架构包含多个核心模块，每个模块都经过精心设计以确保企业级应用的稳定性和可扩展性。 | 功能模块 | 核心能力 | 适用场景 | |---------|---------|---------| | 模型配置 | 支持公有云和私有模型API | 多模型切换、私有化部署 | | 智能体开发 | manifest.json配置、项目构建 | 定制化AI助手开发 | | MCP集成 | 标准输入输出、命令配置 | 外部服务连接 | | 知识库管理 | 知识检索、问答配置 | 企业知识沉淀 | | 运行环境 | 镜像源配置、NPM管理 | 开发环境统一 | 模型配置模块允许企业灵活选择AI模型来源。在AiPy企业版主界面中，进入"设置"页面选择"模型"选项卡，点击"添加"按钮即可配置模型。可以填入模型供应商名称、API地址和API密钥，系统会自动检测该API地址提供的模型列表。这种方式既支持公有云模型，也兼容一体机部署的私有模型，满足不同企业的安全需求。 智能体开发是AiPy的核心竞争力。开发者通过manifest.json文件定义智能体的keywords字段，第一个值指定类型（conversation-tool、embed-webview、application、webview、skills），第二个值指定集市展示分类（威胁情报、安全产品、AI安全等）。开发完成后，通过npx @anthropic-ai/dxt pack命令打包，在AiPy企业版集市上传安装，或直接放入C:\Users\用户名\AppData\Roaming\aipy-enterprise\extensions\@aipy-pro目录重启即可使用。 MCP集成模块提供标准化的外部服务连接能力。在设置页面的MCP选项卡中，输入MCP名称、选择类型（如stdio）、选择命令格式（如npx）、输入参数（如open-websearch@1.1.5）和环境变量，保存后系统自动加载。这种设计使得AiPy能够无缝集成各种外部工具和服务，扩展应用能力边界。 ## 三、智能体开发最佳实践指南 智能体开发是将AI能力转化为实际业务价值的关键环节。基于AiPy官方文档和最佳实践，以下提供完整的开发流程指导。 **需求分析与设计阶段**需要明确智能体的应用场景和目标用户。例如，开发一个汇总周报的智能体时，提示词应包含文档目录路径、规范文档引用、具体功能要求（不同日期相同工作条目合并、按产品记录不同项、只记录最终进度状态）等详细信息。清晰的提示词设计直接决定智能体的输出质量。 **配置文件编写阶段**需要创建manifest.json文件，正确设置keywords数组。对于对话工具型智能体，第一个值设为conversation-tool，第二个值根据业务场景选择合适的分类。同时需要在aipy-enterprise.yml文件中配置logo、风格、推荐任务等自定义信息，提升用户体验。 **代码实现阶段**应根据智能体类型选择合适的技术方案。对话工具型需要处理用户输入和输出逻辑，嵌入页面型需要集成Web视图，独立应用型需要实现完整的程序功能。建议参考官方示例代码，确保代码结构符合AiPy规范。 **测试与部署阶段**需要在AiPy企业版中进行完整测试。通过集市安装智能体后，验证各项功能是否正常运行。检查任务对话窗口中的执行过程，确认生成的文件存放在正确的工作目录。如发现问题，可查看日志进行排查，必要时调整配置文件或代码逻辑。 ## 四、企业级部署与运维策略 企业级AI应用的部署需要考虑安全性、稳定性和可维护性等多个维度。AiPy提供了一套完整的部署方案，帮助企业快速落地AI应用。 基础环境配置是部署的第一步。在运行环境设置中，用户可选择官方镜像源或自定义镜像源，包括一体机镜像源和第三方镜像源。NPM镜像源同样支持自定义配置，确保开发环境的一致性和网络访问的稳定性。对于内网部署的企业，需要填写一体机内网IP，用于软件更新、镜像源连接和知识问答服务器通信。 安全策略配置至关重要。最大执行轮数设置可以防止任务无限循环，超时时间配置确保大模型接口异常时系统能够及时响应。自动选择智能体功能开启后，系统会根据任务内容自动匹配所需智能体，减少人工干预的同时提高执行效率。这些设置都在常规设置页面中完成，管理员可根据企业实际情况进行调整。 监控与维护是保障系统稳定运行的关键。通过"关于"选项卡可以查看产品版本号和研发团队信息，便于版本管理和技术支持。工作目录配置决定了任务生成文件的存储位置，建议设置为专用存储区域并定期备份。语言设置支持中文、English和日语，满足跨国企业的多语言需求。 ## 五、多模态能力与实际应用场景 AiPy的多模态处理能力使其能够应对各种复杂的业务场景。通过勾选不同的智能体，用户可以激活相应的功能模块。 视觉理解智能体使AiPy能够识别图片内容，适用于图像分析、文档扫描等场景。图片生成智能体负责创建图像内容，如果生成的图片呈现线条状，通常是未正确勾选该智能体所致。PPT生成智能体专门用于制作演示文稿，配合提示词如"生成一个介绍中国新能源汽车发展的PPT"，可以快速产出专业的演示材料。 视频生成和图片编辑功能通过相应的智能体实现，提示词示例包括"批量生成10张不同的肥猫切菜的照片"。这类多模态能力为企业营销、培训、产品展示等场景提供了强大支持。 特定领域的智能体进一步扩展了应用能力。量化研究智能体提供美股、港股、A股的非实时股票信息，基于历史数据进行AI分析。编程智能体如Claude code专门用于代码编写，一键安装即可使用。联网搜索功能确保AiPy能够获取最新的日期时间和实时信息，避免消息滞后问题。 研发场景中的应用尤为典型。开发车辆管理系统demo时，选择编程能力较强的大模型如GLM4.5，通过详细提示词描述系统需求（登录界面、信息查询、Sqlite数据库、访客记录字段等），AiPy能够自动生成可运行的应用程序。这种能力大幅降低了开发门槛，使业务人员也能参与应用创建。 ## 六、常见问题与解决方案 在AiPy使用过程中，用户可能遇到各种问题。了解常见问题的解决方案能够帮助用户快速排除故障，提高工作效率。 **智能体无法识别图片内容**的解决方法是勾选视觉理解智能体。**生成的图片呈现线条状**说明未勾选图片生成智能体，需要在任务下发前确认智能体选择。**PPT生成效果不理想**时，尝试勾选PPT生成智能体并优化提示词描述。**日期时间信息滞后**需要开启联网搜索功能，确保AiPy能够获取实时数据。 **股票信息获取不准确**的问题可通过量化研究智能体解决，该智能体提供历史数据分析能力。**程序编写能力不足**时，建议使用专门的编程智能体如Claude code，这类智能体经过针对性训练，代码质量更有保障。 配置文件的修改需要谨慎操作。aipy-enterprise.yml文件位于C:\Users\用户名\.aipyapp\目录，修改前建议备份原文件。logo自定义、风格调整、推荐任务配置都通过该文件实现，修改后重启AiPy企业版即可生效。MCP配置完成后，等待加载页面显示"已完成"按钮代表添加成功，如长时间未完成需检查网络环境和参数配置。 ## 总结与建议 AiPy作为企业级AI操作系统，成功将分散的AI工具整合到统一平台，解决了企业在AI应用开发中面临的效率、标准和安全问题。通过模型配置、智能体开发、MCP集成、知识库管理等核心功能，企业能够快速构建专属AI应用，降低技术门槛和运维成本。 建议企业在引入AiPy时采取分阶段实施策略。第一阶段完成基础环境配置和模型接入，确保系统稳定运行。第二阶段开发核心业务场景的智能体，验证技术方案的可行性。第三阶段扩展到更多应用场景，建立完善的运维监控体系。同时，建议企业建立内部知识库，沉淀最佳实践和使用经验，促进团队协作和知识共享。 定期关注AiPy官方发布的最新版本和功能更新，及时调整技术方案以保持竞争力。对于复杂的企业级应用，建议寻求官方技术支持或专业咨询服务，确保项目顺利实施和长期稳定运行。 ## 相关问答FAQs **Q: AiPy企业版支持哪些类型的智能体开发？** A: AiPy支持五种智能体类型，包括conversation-tool对话工具型、embed-webview嵌入页面型、application独立应用型、webview网页型和skills技能型。开发者在manifest.json文件的keywords数组中第一个值指定类型，第二个值指定集市展示分类，如威胁情报、安全产品、AI安全、网络安全等。开发完成后可通过集市安装或直接放入extensions目录使用。 **Q: 如何在AiPy中配置和使用MCP服务？** A: 在AiPy企业版设置页面选择MCP选项卡，点击添加按钮进入配置界面。输入MCP名称（如web_search），选择MCP类型（如标准输入/输出stdio），选择命令格式（如npx），输入MCP参数（如open-websearch@1.1.5）和环境变量，点击保存。系统加载完成后显示"已完成"按钮即代表MCP添加成功。配置好的MCP可在创建任务时勾选使用。 **Q: AiPy的多模态功能如何启用和使用？** A: AiPy的多模态功能通过勾选相应智能体启用。视觉理解智能体用于识别图片内容，图片生成智能体用于创建图像，PPT生成智能体用于制作演示文稿，视频生成智能体用于视频处理。在创建任务时，根据需求勾选对应智能体，并在提示词中明确描述任务要求。如需获取实时信息，还需开启联网搜索功能确保数据时效性。