AiPy智能体开发：一键创建企业专属AI助手

AiPy 智能体开发支持一键创建企业专属 AI 助手，核心优势包括：1、内置多种智能体模板，覆盖对话工具、独立应用、技能型等场景；2、支持自定义提示词配置，可根据企业需求灵活调整；3、与 Workflow、MCP 深度集成，实现复杂业务流程自动化。以对话工具型智能体为例，开发者只需在 Prompt 项目中输入业务需求描述，系统会自动解析并生成对应智能体配置。例如，输入"根据日报内容汇总周报，不同日期的相同工作条目合并，按产品记录不同项"，AiPy 即可自动创建具备数据合并、分类记录能力的智能体，大幅降低企业 AI 应用开发门槛。

一、AiPy 智能体类型与适用场景

AiPy 平台提供多种智能体类型，每种类型针对不同的企业应用场景设计。在 manifest.json 配置文件中，keywords 字段的第一个值决定智能体类型，具体包括：

智能体类型	标识符	适用场景
对话工具型	conversation-tool	日常对话交互、客服问答
嵌入页面型	embed-webview	在现有系统中嵌入 AI 功能
独立应用型	application	独立运行的 AI 应用程序
网页型	webview	基于网页的 AI 服务
技能型	skills	特定专业能力的 AI 助手

第二个值为集市展示分类，可选范围包括威胁情报、暴露面与脆弱性、安全产品、威胁检测与响应、开发安全、数据安全、AI 安全、安全服务、网络安全、其他、官方精选。企业可根据自身业务领域选择合适的分类，便于在 AiPy 智能体市场中被目标用户发现。

对话工具型智能体适合构建企业知识库问答系统，员工可通过自然语言查询公司制度、项目文档等信息。独立应用型智能体则适用于需要独立运行环境的场景，如自动化报表生成、数据分析等任务。技能型智能体专注于特定领域，例如代码生成、图像识别、数据分析等专业能力。

二、智能体提示词编写规范

提示词是智能体的核心指令，直接影响 AI 助手的行为表现。AiPy 提供多种提示词编写场景，以下是常见示例：

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

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

思维导图生成提示词示例：

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

应用程序开发提示词示例：

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

编写提示词时需注意以下要点：

明确任务目标：清晰描述智能体需要完成的具体任务
指定数据源：如有文件读取需求，需提供完整路径
定义输出格式：说明期望的输出形式和结构
设置约束条件：包括数据校验规则、预置选项等
说明交互方式：描述用户如何与智能体互动

三、AiPy 企业版常规配置

AiPy 企业版提供丰富的配置选项，帮助企业管理员根据实际需求定制平台行为。常规设置包括以下内容：

基础配置项：

语言设置：支持中文、English 和日语三种语言，可根据团队使用习惯选择
风格配置：可在 aipy-enterprise.yml 文件中自定义界面风格
发送快捷键：支持 Ctrl+Enter 或 Enter 两种发送方式
工作目录：设置默认的工作文件存储路径

执行配置项：

最大执行轮数：限制智能体单次任务的最大执行次数
超时时间：设置任务执行的最长等待时间
自动选择智能体：启用后系统会根据任务自动匹配合适的智能体
一体机内网 IP：配置企业内部网络访问地址

合理配置这些参数能够优化智能体执行效率，避免资源浪费。例如，对于复杂的 Workflow 任务，可适当增加最大执行轮数和超时时间；对于高频使用的对话工具型智能体，可启用自动选择功能提升响应速度。

四、智能体能力扩展与优化

AiPy 平台支持多种能力扩展，通过勾选不同智能体可解锁相应功能：

视觉理解能力： 当需要识别图片内容时，勾选视觉理解智能体即可。该能力支持图像内容分析、OCR 文字识别、图像分类等功能。

图片生成能力： 如需生成图片、P 图或创建视频，勾选图片生成/视频生成智能体。示例提示词："批量生成 10 张不同的肥猫切菜的照片"。

PPT 制作能力： 勾选 PPT 生成智能体后，可使用提示词如"生成一个介绍中国新能源汽车发展的 PPT"快速创建演示文稿。

联网搜索能力： 当需要获取实时信息（如日期时间、股票行情）时，开启联网搜索功能。对于股票信息分析，可使用"量化研究"智能体，该智能体拥有美股、港股、A 股所有上市公司非实时股票信息，可基于历史数据用 AI 分析协助研判。

编程能力增强： 如遇到复杂编程任务，可尝试 Claude code 智能体，一键安装使用，专门用于编程场景。

数据分析规范： 进行分析任务前，请先读取前 30 行了解数据格式，然后根据具体数据格式编写合适的分析脚本，报告保存到当前工作目录。

五、企业 AI 应用开发最佳实践

基于 AiPy 平台开发企业级 AI 应用，建议遵循以下最佳实践：

需求分析阶段：

明确业务痛点和自动化需求
评估现有数据资源和系统接口
确定智能体类型和功能范围

开发实施阶段：

选择合适的智能体模板作为起点
编写详细的提示词说明业务逻辑
配置必要的参数和约束条件
进行多轮测试验证功能完整性

部署运维阶段：

将智能体发布到企业私有集市
设置访问权限和使用配额
监控执行日志和性能指标
定期更新优化提示词和配置

安全合规考虑：

敏感数据需进行脱敏处理
遵循企业数据安全规范
设置合理的访问控制策略
定期审计智能体使用情况

通过以上实践，企业可快速构建符合自身需求的 AI 助手，提高运营效率和员工生产力。AiPy 平台持续更新官方文档和最佳实践案例，开发者可随时查阅获取最新指导。

六、常见问题解决方案

在企业智能体开发过程中，可能会遇到一些常见问题，以下是典型问题及解决方案：

问题：智能体执行结果不符合预期 解决方案：检查提示词是否清晰完整，确认数据源路径正确，验证约束条件是否合理。可尝试添加更多示例帮助 AI 理解任务要求。

问题：智能体响应速度较慢 解决方案：优化工作目录设置，减少不必要的文件扫描；调整最大执行轮数和超时时间；考虑使用更高效的模型配置。

问题：多智能体协作出现冲突 解决方案：明确各智能体的职责边界，在 Workflow 中合理编排执行顺序，使用 MCP 协议规范接口调用。

保持与 AiPy 官方文档同步，及时获取功能更新和问题修复信息，能够有效避免常见问题的发生。