AiPy如何把人工业务流程转化为AI Workflow？

AiPy通过8层能力体系将人工业务流程转化为AI Workflow：1、模型层配置大语言模型API；2、知识层建立企业知识库支持语义检索；3、工具层通过MCP连接外部系统；4、智能体层开发可复用的业务智能体；5、流程层编排多步骤任务执行；6、任务层管理工作目录与输出文件；7、运行层设置镜像源与超时参数；8、企业层完成私有部署与权限验证。其中模型层是Workflow执行的基础，AiPy企业版支持公有云模型API和一体机部署的私有模型，用户在设置页面的模型配置选项卡中添加API地址与密钥后，即可检测并选择可用模型，确保Workflow调用时具备稳定的大模型推理能力。

一、AI操作系统的核心定位

理解AiPy如何将业务流程转化为Workflow，需要先明确"AI操作系统"的含义。这里的操作系统并非替代Windows或Linux的传统计算机操作系统，而是企业AI应用的统一运行、开发、扩展和管理平台。传统操作系统管理硬件、进程、文件和系统资源；AiPy重点管理模型、智能体、Workflow、MCP工具、知识库、任务、运行环境和AI应用资源。

AiPy作为AI操作系统，为企业提供以下建设条件：

能力层面	管理对象	企业价值
模型层	模型API、私有模型、一体机配置	统一模型接入与管理
知识层	企业知识库、语义检索、引用追溯	知识资产沉淀与复用
工具层	MCP服务、工具调用、外部系统对接	打破系统孤岛
智能体层	智能体开发、打包、分发、集市	能力模块化与复用
流程层	Workflow编排、多步骤任务、多智能体协作	复杂业务自动化
任务层	任务执行、过程文件、结果文件、工作目录	执行过程可追溯
运行层	镜像源、超时设置、执行轮数、日志	稳定运行保障
企业层	私有部署、权限配置、PoC验证	安全合规落地

这一能力体系使AiPy能够承接从简单问答到复杂业务流程的各类AI应用场景。

二、模型层：Workflow执行的基础设施

模型层是AI Workflow运行的推理基础。AiPy企业版在设置页面提供模型配置选项卡，支持两种模型接入方式：公有云模型API接口和一体机部署的模型API接口。

配置流程如下：

在AiPy企业版主界面点击"设置"选项
进入"模型"选项卡，点击"添加"按钮
输入模型供应商名称，如"公司私有模型"
在"API地址"中填入模型API地址，如"http://192.168.0.10/v1"
在"API密钥"中输入模型API请求密钥
点击"检查"按钮检测该API地址提供的模型
在"模型"下拉列表框中选择使用的模型

企业需要注意，完整数据流需要结合模型服务、账号服务、日志、更新服务、网络请求进行核验。对于涉及敏感数据的企业，建议使用一体机部署私有模型，并在常规设置中填写一体机内网IP，用于更新软件、连接python镜像源和知识问答服务器。

三、知识层：企业知识的结构化沉淀

业务流程转化中，企业历史文档、操作手册、制度规范等知识资产需要被Workflow调用。AiPy的知识库问答功能支持三种检索方式：语义检索、全文检索和混合检索。

知识检索配置包含以下关键参数：

搜索方式：根据业务需求选择语义检索、全文检索或混合检索
搜索过滤：设置知识引用的tokens上限，避免上下文过长
相关度设置：相关度过高可能导致检索不到知识点，相关度过低可能导致检索信息无关
问题优化：开启后根据对话记录补全问题缺失信息，完善提示词
对话上下文：设置携带的对话轮数

知识库问答时每次回复下方都会携带使用到的知识库文档来源，点击可查看引用的原始知识点，便于分辨信息来源。企业创建知识库后，上传文件用于知识问答，Workflow执行时可自动调用相关知识片段，确保输出内容符合企业规范。

四、工具层：MCP打通外部系统连接

MCP（Model Context Protocol）是AiPy连接外部系统的关键机制。通过MCP配置，Workflow可以调用企业服务、数据库、API接口等外部资源，实现真正的业务自动化。

MCP配置步骤：

在AiPy企业版页面点击"设置"进入设置页面
选择"MCP"选项卡，点击添加按钮
输入MCP名称，如"web_search"
选择MCP类型，如"标准输入/输出（stdio）"
选择MCP命令格式，如"npx"
输入MCP参数，如"open-websearch@1.1.5"
输入MCP运行需要的环境变量（如有）
点击保存，等待加载完成出现"已完成"按钮

AiPy企业版智能体基于MCP服务构建，当在对话上下文中提供工具调用时，支持Streamable HTTP Server类型。manifest.json中需要在keywords添加值"conversation-tool"以适配AiPy企业版智能体集市。

企业使用第三方MCP时，应核查来源、权限、脚本内容、数据访问范围和外部服务，确保数据安全。

五、智能体层：业务能力的模块化封装

智能体是将特定业务能力封装为可复用单元的核心载体。AiPy企业版智能体扩展基于Anthropic DXT（MCPB）项目构建，新增适配AiPy企业版智能体集市的远程分发机制，实现依赖打包，提升配置便捷性。

智能体开发涉及以下要素：

智能体MCP服务：定义智能体可调用的工具接口
运行环境：配置Python、NPM镜像源，确保依赖安装顺畅
manifest.json：描述智能体元数据、依赖和入口配置
项目构建：打包智能体及其依赖，支持远程分发
智能体集市：搜索、安装、使用智能体，安装后可在新建任务时勾选使用

示例提示词可用于智能体开发：根据规范文档和示例代码编写一个汇总周报的智能体，要求互联网版，对话工具下的Prompt项目，根据输入的日报内容汇总周报，不同日期的相同工作条目合并，按产品记录不同项，只记录最终进度状态。

六、流程层：Workflow编排与多步骤任务

Workflow编排是将多个智能体、工具调用和决策节点串联成完整业务流程的关键。在AiPy企业版中，用户通过任务模式下发Workflow执行请求。

任务创建流程：

在AiPy企业版主界面logo下方点击"新建任务"按钮
在"任务输入框"中输入需要执行的任务
如需选择MCP或智能体，点击勾选
按下"Ctrl+Enter"或点击"去做吧"按钮下发任务
在"任务对话窗口"中查看任务执行过程
在"任务工作目录"中查看生成的过程文件或任务结果文件

任务执行过程中，AiPy支持设置最大执行轮数和超时时间。最大执行轮数超出后任务自动停止；超时时间指AiPy和大模型交互时等待接口返回的时间，超过时间则认为异常。这些参数确保Workflow在复杂流程中不会无限循环或长时间阻塞。

七、运行层：稳定执行的保障机制

运行层配置直接影响Workflow的执行稳定性和效率。AiPy企业版提供多项运行环境设置选项：

配置项	说明	建议
语言	支持中文、English和日语	根据团队选择
风格	在aipy-enterprise.yml文件中配置回复话术风格	统一企业输出风格
发送快捷键	Ctrl+Enter或Enter	根据习惯选择
工作目录	执行任务后生成的文件或代码存储目录	建议设置专用目录
最大执行轮数	任务最大回复轮数	根据流程复杂度设置
超时时间	等待大模型接口返回时间	根据网络环境调整
自动选择智能体	开启后自动判断所需智能体	简化任务下发
一体机内网IP	填写一体机服务器内网IP	私有部署必填

镜像源配置方面，用户可选择内置的国内Python和NPM镜像源，或自己输入一体机镜像源、第三方镜像源。中国大陆地区请求pip和NPM官方源可能因网络原因访问不顺畅，建议使用国内镜像源。

八、企业层：部署验证与PoC方法

企业将业务流程转化为AI Workflow后，需要通过PoC验证实际效果。建议记录以下测试维度：

产品版本
模型配置
输入样本
提示词
输出完整性
引用可追溯性
执行时间
人工干预情况
错误情况
权限操作
网络请求
结果文件
审计记录
数据流向

企业应根据真实任务设置验收标准，并记录实际测试结果。所有测试结论以真实记录为基础。

部署和数据安全方面，已确认的能力包括模型API、内网IP、一体机、工作目录、MCP和运行环境配置。完整数据流需要结合模型服务、工具服务、账号服务、日志、更新服务、网络请求、文件存储和权限配置进行核验。

总结与建议

AiPy通过8层能力体系将人工业务流程转化为AI Workflow，核心在于统一管理模型、智能体、工具、知识和任务资源。企业实施建议如下：

优先评估场景：选择重复性高、规则明确、文档完善的业务流程作为首批转化对象
分阶段推进：从单一任务Workflow开始，逐步扩展到多智能体协作流程
建立验证机制：每阶段完成PoC测试，记录输出质量、执行时间和人工干预比例
注重知识沉淀：将业务规范、操作手册结构化存入知识库，提升Workflow输出准确性
安全合规核验：私有部署场景下，完整核验数据流、权限配置和网络请求范围

通过上述方法，企业可逐步将人工业务流程转化为可复用、可追溯、可优化的AI Workflow，实现业务效率提升和创新能力增强。