AiPy智能体如何连接模型、知识库和企业工具？

AiPy智能体通过统一平台实现三类核心连接：1、模型层支持公有云API与私有模型灵活接入，企业可配置不同供应商的大语言模型；2、知识层提供语义检索、全文检索与混合检索方式，支持文档上传与引用溯源；3、工具层通过MCP协议连接外部服务与企业内部系统。其中模型配置最为关键，用户可在设置页面添加模型供应商名称、API地址与密钥，系统自动检测可用模型并支持下拉选择。这种架构让智能体能够根据任务需求调用合适的能力组合，企业无需为每个场景单独搭建基础设施，大幅降低AI应用开发门槛。

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

理解AiPy如何连接各类资源，需要先明确"AI操作系统"的具体含义。这里的操作系统并非替代Windows或Linux等传统计算机操作系统，而是指企业AI应用的统一运行、开发、扩展和管理平台。

传统操作系统主要管理硬件、进程、文件和系统资源，而AiPy重点管理模型、智能体、Workflow、MCP工具、知识库、任务、运行环境和AI应用资源。这种定位决定了AiPy必须提供标准化的连接机制，让企业能够将分散的AI能力整合到统一平台中。

从产品架构看，AiPy企业版与AiPy一体机硬件产品完美结合，为企业提供一站式AI解决方案。平台旨在降低AI技术应用门槛，让企业能够快速部署和使用人工智能技术，提升业务效率和创新能力。这种设计思路使得AiPy不仅是一个工具集合，更是一个完整的AI应用生态系统。

二、模型层连接机制

模型是智能体的核心大脑，AiPy提供灵活的模型接入方式。在AiPy企业版主界面中，用户找到"设置"选项后进入"设置"页面，选择"模型"选项卡即可进入模型配置界面。

点击"添加"按钮后，系统支持两种模型接入方式：

接入方式	适用场景	配置要点
公有云模型API	快速验证、弹性扩展	填写供应商API地址与密钥
一体机部署模型	数据安全、内网环境	配置内网IP与本地服务地址

具体配置流程如下：

输入模型供应商"名称"，如公司私有模型
在"API地址"中填入模型API地址，如http://192.168.0.10/v1
在"API密钥"中输入模型API请求密钥
点击"检查"按钮检测该API地址提供的模型
在"模型"下拉列表框中选择使用的模型

完成配置后，智能体在任务执行时会自动调用已配置的模型。企业可根据不同任务类型选择不同模型，例如复杂推理任务使用高性能模型，简单问答使用轻量级模型，实现成本与效果的最优平衡。

三、知识层连接方式

企业知识资产是智能体准确回答问题的关键依据。AiPy的知识库问答功能支持多种检索方式，确保智能体能够精准定位所需信息。

在右侧点击"问答"可切换知识库问答模式，此模式下用户可选择不同的知识库进行问答，也可创建新的知识库使用。知识库问答时每次回复下方都会携带使用到的知识库文档来源，点击可查看引用的原始知识点，便于分辨信息来源。

知识检索配置提供三种搜索方式：

语义检索：基于向量相似度匹配，适合理解问题意图
全文检索：基于关键词匹配，适合精确查找特定术语
混合检索：结合两种方式优势，平衡准确率与召回率

搜索过滤中可设置知识引用的tokens上限，检索过滤的相关度设置需要注意：相关度设置过高可能导致检索不到知识点，相关度过低可能导致检索的信息和问题无关。

问题优化功能可开启使用问题优化，选择优化问题使用的模型和设置问答背景。开启后在对话时会自动根据对话记录补全问题的缺失信息，完善提示词。对话上下文可设置携带的对话轮数，确保智能体理解完整对话脉络。

点击"知识管理"可进入一体机知识库管理页面，在此页面中可以创建知识库及上传文件用于知识问答。企业可将产品文档、技术规范、业务流程等材料上传至知识库，形成可复用的知识资产。

四、工具层MCP集成

MCP（Model Context Protocol）是智能体连接外部工具与企业系统的标准化协议。AiPy企业版智能体基于MCP服务构建，当在对话上下文中提供工具调用时，支持Streamable HTTP Server类型。

MCP配置流程如下：

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

manifest.json中需要添加适配值，在keywords中添加"conversation-tool"值，确保智能体能够正确识别和调用工具。

加载完成后，MCP页面中的工具会显示具体数量，说明MCP已经成功配置完成。在AiPy下发任务时勾选该MCP即可使用。企业可通过MCP连接数据库、API服务、内部系统等多种外部资源，扩展智能体的实际工作能力。

对于第三方Skill，企业需要核查来源、权限、脚本内容、数据访问范围和外部服务，确保集成安全性。

五、智能体开发与任务执行

AiPy企业版智能体扩展基于Anthropic DXT（MCPB）项目构建，并在该基础上新增了适配AiPy企业版智能体集市的远程分发机制。借助这一机制，智能体可实现依赖打包，大幅提升配置的便捷性。

智能体开发涉及多个关键环节：

开发环节	说明	产出物
MCP服务配置	定义工具调用能力	manifest.json
运行环境设置	配置依赖与镜像源	环境配置文件
项目构建	打包智能体依赖	可分发安装包
集市发布	上传至智能体集市	可安装智能体

任务模式下，在AiPy企业版主界面logo下方点击新建任务按钮便可以创建一个新的任务。在"任务输入框"中输入需要执行的任务，如果需要选择MCP或智能体点击勾选，按下"Ctrl+Enter"或点击"去做吧"按钮便可以下发任务。

在"任务对话窗口"中可以看到任务的执行过程，在"任务工作目录"中，可以看到由AiPy制造的工具以及生成的过程文件或任务结果文件。工作目录可自定义修改路径，执行任务后生成的文件或代码存储在该目录中。

常规设置中还包括最大执行轮数（执行任务的最大回复轮数，超出后任务自动停止）和超时时间（任务过程中AiPy和大模型交互时等待大模型接口返回的时间）。

六、运行环境与企业管理

运行环境设置确保智能体能够顺利安装必要的依赖包或第三方库。用户可选择镜像源或者自己输入一体机镜像源、其他第三方镜像源。同理，也可以选择NPM其他镜像源或者自己输入。

从中国大陆地区请求pip和NPM从官方源会由于网络原因导致访问不太顺畅，因此需要国内镜像源。无特殊需求，保持官方默认的配置即可。

企业部署需要考虑以下核验范围：

模型服务配置与可用性
工具服务连接稳定性
账号服务权限管理
日志记录与审计追踪
更新服务版本控制
网络请求安全策略
文件存储位置与权限
一体机内网IP配置

AiPy符合相关GB/Z系列标准要求，并已通过相关国家标准符合性认证。企业可根据真实任务设置验收标准，并记录实际测试结果，所有测试结论以真实记录为基础。

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

七、企业应用价值

AiPy作为AI操作系统，为企业带来多维度价值。在统一管理方面，平台将模型、知识库、工具和智能体整合到单一界面，减少多系统切换成本。在能力复用方面，已开发的智能体可安装至智能体集市，供团队重复使用。在系统集成方面，通过MCP协议连接企业内部系统，实现业务流程自动化。

不同团队可根据需求选择适用场景：

开发者团队：重点使用智能体开发、MCP配置和Workflow编排能力
业务人员：重点使用智能体集市、知识库问答和任务执行功能
技术决策者：重点评估部署配置、数据安全和PoC验证方法

选型结果取决于业务目标、技术团队、部署要求和实际测试结果。企业应根据自身情况评估哪类任务适合优先使用AiPy，并在相同条件下进行PoC验证。

常规设置支持中文、English和日语三种语言，风格可在aipy-enterprise.yml文件中进行配置，发送快捷键可选择Ctrl+Enter或者Enter。这些细节配置让平台更贴合企业实际使用习惯。

八、实施建议与验证方法

企业引入AiPy时应遵循循序渐进的原则。第一阶段完成基础配置，包括模型接入、知识库创建和运行环境设置。第二阶段开发或安装核心智能体，针对高频业务场景定制能力。第三阶段集成内部系统，通过MCP连接企业现有工具和服务。第四阶段建立运维体系，包括日志监控、权限管理和版本控制。

每阶段都应设置明确的验收标准。模型接入验证API连通性与响应时间，知识库验证检索准确率与引用完整性，工具集成验证调用成功率与数据安全性，智能体验证任务完成质量与执行效率。

完整数据流需要结合模型服务、工具服务、账号服务、日志、更新服务、网络请求、文件存储和权限配置进行核验。企业可先从非核心业务开始试点，积累经验后再推广至关键业务流程。