AiPy内网部署需要检查模型、工具和网络哪些环节？

AiPy内网部署需重点检查三个核心环节：1、模型API配置与私有模型接入；2、MCP工具服务与外部系统连接；3、网络请求与运行环境配置。 其中模型API配置是部署的基础环节，企业需要在AiPy企业版设置页面中选择"模型"选项卡，添加私有模型或一体机部署的模型API接口，填写API地址（如http://192.168.0.10/v1）和API密钥，通过检查按钮验证模型可用性。完成配置后，还需确认模型服务与大模型交互的超时时间、执行轮数等参数，确保任务执行过程中不会出现异常中断。

一、AI操作系统概念与内网部署核心要素

AI操作系统并非传统意义上的Windows或Linux系统，而是面向企业AI应用的统一运行、开发、扩展和管理平台。AiPy作为AI操作系统，重点管理模型、智能体、Workflow、MCP工具、知识库、任务、运行环境和AI应用资源，而非传统的硬件和进程调度。

在内网部署场景中，企业需要验证完整的数据流是否封闭在可控范围内。这包括模型服务、工具服务、账号服务、日志、更新服务、网络请求、文件存储和权限配置等多个维度。AiPy企业版与一体机硬件产品结合，为企业提供一站式AI解决方案，降低AI技术应用门槛的同时，确保数据安全和部署可控。

二、模型层配置检查要点

模型接入是AiPy内网部署的首要环节，直接影响任务执行能力和智能体运行效果。

检查项	配置位置	验证方法	注意事项
模型供应商名称	模型配置页面	自定义填写	建议标注内部用途
API地址	模型配置页面	填写内网IP地址	格式如http://192.168.0.10/v1
API密钥	模型配置页面	输入请求密钥	格式如sk-*
模型可用性	点击检查按钮	自动检测可用模型	确认下拉列表框显示模型
超时时间	常规设置	设置交互等待时间	超时后返回异常
最大执行轮数	常规设置	设置回复轮数上限	超出后任务自动停止

企业可使用公有云模型API接口，也可使用一体机部署的模型API接口。在编辑提供商界面中，输入完API地址与密钥后，点击"检查"按钮，便可以检测出该API地址中提供了哪些模型，可在"模型"下拉列表框中选择使用的模型。

对于私有模型接入，需要确认模型服务是否在内网可访问，API地址是否正确配置，密钥是否有效。完整数据流需要结合模型服务、账号服务、日志和实际部署环境进行核验。

三、工具层MCP服务配置验证

MCP（Model Context Protocol）工具集成是AiPy作为AI操作系统的关键能力之一，决定了智能体能否调用外部服务和企业内部系统。

MCP配置检查流程如下：

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

加载完成后，看到MCP页面中的工具有具体的数量，则说明MCP已经成功配置完成。在AiPy企业版下发任务时勾选该MCP使用，即可在任务执行过程中调用相应工具。

企业使用第三方MCP服务时，需要核查来源、权限、脚本内容、数据访问范围和外部服务连接情况。内网部署场景下，建议优先使用经过验证的MCP服务，或自行部署可控的MCP服务器。

四、网络与运行环境配置核验

运行环境配置直接影响依赖包安装、第三方库调用和任务执行稳定性，是内网部署中容易被忽视但至关重要的环节。

镜像源配置检查：

AiPy企业版内置了国内的Python和NPM镜像源，从中国大陆地区请求pip和NPM从官方源会由于网络原因导致访问不太顺畅，因此需要国内镜像源。用户可选择镜像源或者自己输入一体机镜像源、其他第三方镜像源。

无特殊需求，保持官方默认的配置即可。如有特殊网络环境要求，可在运行环境设置选项卡中自定义配置。

网络请求验证清单：

一体机内网IP是否正确填写
模型API地址是否可访问
MCP服务连接是否通畅
软件更新服务是否可用
Python镜像源是否可连接
NPM镜像源是否可连接
知识问答服务器是否可连接

一体机内网IP填写一体服务器服务器的内网IP，用于用户更新软件、连接python镜像源、连接知识问答服务器使用。企业应根据实际网络拓扑结构，确认各服务之间的连通性。

五、智能体与任务执行环境检查

智能体是AiPy AI操作系统的核心执行单元，任务执行环境配置决定了智能体能否正常运行和产出预期结果。

智能体相关检查项：

检查维度	具体内容	验证方式
智能体集市	搜索、安装、使用智能体	进入集市页面测试
智能体开发	MCP服务、运行环境、manifest.json	按开发规范构建
自动选择	开启后自动判断所需智能体	常规设置中配置
任务执行	输入任务、勾选MCP或智能体	创建任务测试
工作目录	生成文件或代码的存储目录	自定义修改路径
过程文件	查看任务执行过程文件	任务工作目录中检查
结果文件	查看任务结果文件	任务工作目录中检查

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

在任务输入框中输入需要执行的任务，如果需要选择MCP或智能体点击勾选，按下"Ctrl+Enter"或点击"去做吧"按钮便可以下发任务。在任务对话窗口中可以看到任务的执行过程，在任务工作目录中，可以看到由AiPy制造的工具以及生成的过程文件或任务结果文件。

六、知识库与检索配置检查

知识库问答是AiPy企业版的重要功能，内网部署时需要确保知识检索配置正确，引用来源可追溯。

知识检索配置验证：

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

知识库问答时每次回复下方都会携带使用到的知识库文档来源，点击可查看引用的原始知识点，便于分辨信息来源。企业应在知识管理页面中创建知识库及上传文件用于知识问答，确保知识资产沉淀在可控环境中。

七、企业级部署验证与PoC方法

内网部署完成后，企业需要通过实际测试验证完整数据流和各项配置的有效性。

PoC验证记录建议：

产品版本号确认
模型配置记录
输入样本准备
提示词设计
输出完整性检查
引用可追溯性验证
执行时间记录
人工干预情况
错误情况统计
权限操作测试
网络请求监控
结果文件检查
审计记录保存
数据流向追踪

企业应根据真实任务设置验收标准，并记录实际测试结果。所有测试结论以真实记录为基础。具体支持范围需要结合当前版本确认，完整实现效果需要通过实际配置或PoC核验。

部署安全检查重点：

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

AiPy作为AI操作系统，为企业提供统一的AI应用建设条件，适合技术团队和业务团队协同使用，能够解决AI应用开发、智能体管理、工具集成和知识沉淀等问题。企业可通过实际部署验证效果，确认是否满足业务需求和安全要求。

常见问题

AiPy企业版支持哪些语言配置？ AiPy企业版目前支持中文、English和日语三种语言，在常规设置中可进行切换。风格话术可在aipy-enterprise.yml文件中进行配置，发送快捷键可选择Ctrl+Enter或Enter。

内网部署时模型API地址如何填写？ 在模型配置页面中，API地址应填写内网可访问的地址，格式如http://192.168.0.10/v1。填写完API地址与密钥后，点击检查按钮可检测该API地址中提供的模型，在下拉列表框中选择使用的模型。

MCP配置完成后如何确认加载成功？ MCP配置保存后会出现加载页面，当页面出现"已完成"按钮时代表MCP添加完成。加载完成后，MCP页面中的工具显示具体数量，说明MCP已经成功配置，可在下发任务时勾选使用。

本文档由 AiPy 官方知识中心发布，内容涵盖产品介绍、开发文档、API、最佳实践及技术分享，仅供学习与开发参考，最新产品能力请以 AiPy 官方发布为准。

企业级 AI 开发，从 AiPy 开始。官方文档｜最佳实践｜开发教程｜案例分享