AiPy Pro使用指南

下载

官方下载地址：https://www.aipyaipy.com/，根据您所使用的操作系统，选择对应版本进行下载安装。安装流程简洁便捷，按照安装程序的页面提示逐步选择安装路径，完成确认即可顺利部署，操作体验与常规客户端软件安装一致。

安装

安装好之后，打开AiPy Pro会进入一个登录页面，需要先注册并登录，登录成功后等待初始化完成后即可进入使用页面。

如果遇到登录后反复跳转到登录页面，建议检查下是否有开启VPN代理，需要关闭后，退出AiPy Pro客户端再次进行尝试。若问题仍然存在，可参考官方论坛：https://d.aipyaipy.com/d/379提到的步骤进行排查。

如果遇到初始化失败，可以尝试删除“C:\Users\<你的电脑用户名>\AppData\Roaming\aipy-pro\venv”这个目录后，再重启AiPy Pro客户端。

点击新建任务后，即可在对话框中输入任务提示词开始使用AiPy Pro，页面中有很多推荐任务，如果不清楚如何使用，建议点击推荐任务先尝试执行，以观察效果并了解AiPy Pro的工作过程。

新建任务后，若出现点击“去做吧”后没有反应、发送消息后没有回复，可按照以下几个方向操作和排查：

1. 退出AiPy Pro程序，再“以管理员身份运行”AiPy Pro。

2. 如果AiPy Pro的安装目录是“C:\Program Files\”，可以尝试更换一个安装目录，这个目录是 Windows 的系统保护目录，普通用户权限无法直接写入文件。

3. 如果有开启VPN代理，可关闭代理后再次尝试。

4. 排查电脑中的防火墙、杀毒软件，是否限制了AiPy Pro联网。

具体可以参考https://d.aipyaipy.com/d/379这里的官方论坛进行排查，如果仍然无法解决，可以在官方论坛https://d.aipyaipy.com/d/13中扫描二维码进群获取技术支持。

任务

任务开始区

在这里输入用户提示词（想完成的具体的任务或其他问题），点击发送即可开始启动任务。可以选择AiPy Pro的工作模式、任务执行工具、执行任务的大模型等。

  • 执行任务的工具，包括以下工具：
    • 选择文件：支持文件和文件夹，选择后会自动在输入框中填入对应的路径。
    • 地图导航：当任务需要获取地理位置相关信息时，建议开启，可以用来查询实时天气、GPS位置、地图路线规划、公交、地铁、火车车次、附近店铺等，选择后对应图标处于高亮状态。
    • MCP服务：需要在设置中，有自定义设置过MCP服务才可选中，当任意一个MCP服务被选中时，此图标都将处于高亮状态。
    • 任务规划与复用：对历史执行效果较好的任务进行复用，保障任务执行效果。可以在历史任务区，鼠标右击某个任务进行导出，会生成一个.aipy文件，点击这里的任务规划与复用后，上传这个.aipy文件，并说明需求则会以历史成功任务为基础，再次高效完成相同或近似任务。
    • 智能体应用：点击可以选择需要使用的智能体，比如需要识别图片中的内容，就需要选择视觉理解智能体。当任意一个智能体被选中时，此图标都将处于高亮状态。
    • 联网搜索：当任务需要获取最新互联网实时信息时，建议开启，可以辅助生成更准确的任务结果。选择后此图标将处于高亮状态。
  • 模型选择：选择执行任务使用的大模型，大模型能力越强，任务的成功率也就越高，如果您是小白不知道怎么选，建议保持默认的auto，auto模型是官方定期测评得出的性价比最高的模型组合。
  • 终端：点击终端即可进入当前工作目录的cmd命令行管理页面，可以在终端中手动执行任务过程中产生的代码，安装工具等，如下截图：

任务执行区

这里是AiPy Pro执行任务过程中的交互过程，可以查看任务执行的完整过程、时间、任务代码的源码、回到任务顶部等操作。

历史任务区

AiPy Pro任务界面的左上角区域是历史任务区域，可以对历史任务进行查看、删除（批量删除）、重命名、导出等操作，如下截图标注。

工作目录区

这里是AiPy Pro在执行任务过程中产生的任务文件，包含过程文件和结果文件。双击某个具体的文件即可直接打开查看文件，也可以在设置中调整工作目录存储的路径。

每个任务的工作目录中都会有一个默认的task.json文件会在工作目录中，这个文件也是任务过程中产生的文件，如果AiPy Pro在执行任务过程遇到问题，可以查看这个文件中是否有报错信息。

问答

在任务模式下，AiPy Pro会编写程序、调用Skills（智能体）自动化完成任务，如：完成处理表格数据、生成html、生成PPT、生成图片等任务并交付结果。而在问答模式下，AiPy Pro仅回答用户的问题，不会执行任务。

定时

可以设置一些定时任务，比如定时获取新闻、定时提醒发周报等等。此功能需要保持AiPy Pro客户端在线运行，不可退出，否则定时任务无法执行。

Skills（智能体集市）

这里包含一些AiPy Pro内置的Skills和智能体应用，使用前需要先在智能体集市中安装，然后点击“去使用”，或者在新建任务的时候选择对应的智能体，之后该任务就会使用智能体完成任务，效果更好。

AiPy Pro也支持上传Skills和自建智能体，对于一些常用场景，用户可上传Skills或自建智能体后使用。如果需要自建智能体，可以参考智能体集市中的“智能体开发指南”模块。如果需要的Skills在AiPy Pro中没有内置，也可以直接在Skills（智能体集市）页面的右上角点击上传。

Skills和智能体使用上有区别：组件左上角有“Skills”标识为Skills，没有该标识的就是智能体。

智能体使用

方法一：在集市中，选择智能体并点击“去使用”之后，在任务开始区中的智能体应用会处于高亮状态，把鼠标放上去会显示当前所选择的智能体。

方法二：直接在任务开始区域中点击智能体应用的图标，会弹出当前已经安装过的智能体，点击需要使用的智能体即可。

例如：

图片/视频生成：需要让AiPy生成图片，则需要使用“图片生成”智能体AI生图，否则AiPy可能直接编写Python脚本来画图，效果不佳。视频生成则需要选择“视频生成”的智能体。

AI识图：如果需要识别图片中的内容，可以选择“视觉理解”智能体，轻松识别图片内容。

如果想让AiPy生成PPT，则必须勾选“PPT生成”智能体，生成的PPT有模板，并且美观。

Skills使用

方法一：在Skills（智能体集市）中找到对应的Skills，点击去使用，然后会跳转到任务页面，此时在任务页面也可以看到选择的Skills，此时直接下发任务即可。

方法二：在安装好Skills后，直接在任务提示词中说明需要使用的Skills名称，如果需要同时使用多个skills，也可以在提示词里面说明。

Claw

AiPy Pro 手机控制功能，支持通过手机 APP 远程连接操控。无需守在电脑前，即可便捷下达任务、查看执行进度，灵活控制 AiPy Pro，打破场景限制，实现 7×24 小时高效管控，大幅提升操作效率。

支持微信、QQ、飞书三种通讯软件来控制AiPy Pro。

微信：最简单的操作，直接使用微信扫一扫功能，扫描AiPy中的二维码即可，扫描连接成功后，需要重启AiPy Pro客户端。（注意：手机微信版本需要8.0.69及以上）

QQ和飞书的远程控制AiPy Pro还需要去他们各自的开发平台创建机器人，并做好相应的配置后，在AiPy Pro中填写上APP ID和APP Secret。具体可以参考AiPy Pro中提供的教程进行操作。

任务悬赏

对于完成效果不佳、未达目的的任务，可以在任务完成后，发布悬赏，会发布到社区，求助网友。

玄幻模式

点击切换到玄幻模式，玄幻皮肤样式如下，在玄幻皮肤的右上角，可以切换到窗口模式。需要50积分解锁此功能。充值1元得1积分，使用100次得1积分，邀请一个用户得10积分。可以在AiPy Pro侧边栏左下角的个人中心查看当前积分。

玄幻模式下的皮肤示例如下：

设置

常规设置

  • 发送快捷键：可以根据个人使用习惯选择使用Ctrl+Enter组合键发送或者使用Enter键直接发送。
  • 自动下载更新：开启后，若AiPy Pro有新版本会自动下载，也可以手动点击后面的检查更新来下载新版本。
  • 工作目录：执行任务后生成的文件或代码的存储目录，可点击自定义修改路径，需要修改为安装目录以外的其他目录，修改后在新建的任务中开始生效。
  • 最大执行轮数：执行任务的最大回复轮数。
  • 超时时间：任务过程中，AiPy Pro和大模型交互时，等待大模型接口的返回时间，超过时间则认为异常，不再等待，返回异常。
  • 自动选择智能体：默认开启，可以帮助用户自动选择合适的智能体完成任务，关闭后，每次都需要用户手动选择智能体，AiPy Pro才会调用智能体来完成任务。

外观设置

风格与记忆设置

模型设置

在首次注册或登录后，模型设置中会有一个默认的trustoken的模型接口，这个是AiPy Pro官方的API，推荐使用，官方API和AiPy Pro有适配，任务执行效果更好。

在模型设置中，点击添加，可以添加一些第三方厂商的大模型API，比如选择硅基流动的API，然后输入硅基流动的api_key，如下截图，添加成功后就可以在任务执行区选择对应的模型了。（注：自定义模型功能需要50积分解锁。充值1元得1积分，使用100次得1积分，邀请一个用户得10积分）

MCP设置

MCP（Model Context Protocol，模型上下文协议） ，2024年11月底，由 Anthropic 推出的一种开放标准，旨在统一大模型与外部数据源和工具之间的通信协议。MCP 的主要目的在于解决当前 AI 模型因数据孤岛限制而无法充分发挥潜力的难题，MCP 使得 AI 应用能够安全地访问和操作本地及远程数据，为 AI 应用提供了连接万物的接口。

AiPy Pro内置了联网搜索和地理信息服务的MCP功能，并且也支持用户自行添加MCP功能，以添加一个Tavily MCP为例，Tavily是一款专为AI应用设计的搜索引擎，它能够提供实时、准确的搜索结果,智能化的查询建议以及深入的研究能力。

添加方法如下：

1. 从网站注册获取API KEY。

2. 在AiPy Pro中，点击添加，配置MCP服务。截图如下：

3. 配置MCP完成后，点击保存，会出现如下一个页面，等待MCP加载变成“已完成”即可关闭窗口。

加载完成后，看到MCP页面中的工具有具体的数量，则说明MCP已经成功配置完成了。

4. 在AiPy Pro下发任务时勾选该MCP使用。

运行环境

为了AiPy Pro在执行任务过程中，可以顺利安装必要的依赖包或第三方库，内置了一些国内的Python和NPM的镜像源（从中国大陆地区请求pip和NPM从官方源会由于网络原因导致访问不太顺畅，因此需要国内镜像源）。无特殊需求，这里保持官方默认的配置即可。

最佳实践

日常使用小技巧

提示词优化

很多用户在使用AI应用时最大的困惑是提示词写不好，提示词被誉为AI时代的编程语言，是人和大模型交互的关键，提示词写不好AI往往理解不到用户的真实意图，导致输出效果不佳。建议用户使用AiPy Pro做复杂任务时，优先使用问答模式让AiPy Pro优化提示词，然后再切换任务模式下发任务，这样会事半功倍。

模型选择

大模型是AiPy Pro的基座，大模型是否聪明会直接关乎任务的成功与否，因此AiPy官方会定期测评各新发布模型与AiPy的适配度情况，可以在https://www.aipyaipy.com/官网首页中查看定期测评报告，选择更适合的模型。

特定任务选择特定智能体

AiPy的功能非常强大，学生党、上班族都可以使用AiPy帮您完成任务，在粉丝沟通群中，我们发现用户经常反馈效果不佳是因为没有勾选智能体，智能体是针对特定任务优化的工具，建议如果有对应任务适合的智能体优先选择智能体后再下发任务，比如：

  • AiPy不能识别图片的内容？——可以，勾选视觉理解智能体就好啦。
  • AiPy生成的图片怎么是线条？——那是因为没有勾选图片生成智能体哦。
  • AiPy生成的PPT太丑了？——试试把AiPy中的PPT生成智能体勾选上看看。
  • AiPy都不能准确获取今天的日期和时间，消息滞后了？——需要把联网搜索功能也开启~
  • AiPy获取股票信息不准？——咱们有“量化研究”智能体，拥有美股、港股、A股所有上市公司非实时股票信息，可以基于历史数据用AI分析协助您研判分析股票信息。
  • AiPy编写程序不行？——试试Claude code，一键安装使用，是专门编程的智能体。

AiPy使用场景最佳实践

制作PPT

使用AiPy制作PPT，勾选PPT生成智能体，提示词：生成一个介绍中国新能源汽车发展的PPT。

生成图片视频

使用aipy生成图片、P图、生成视频等，勾选图片生成/视频生成智能体，提示词：批量生成10张不同的肥猫切菜的照片。

提示词：修复这张老照片，让照片色彩更加柔和、充实、现代一些。

超大文件数据分析

运维人员使用AiPy自动分析10G大日志文件，提示词：

C:\Users\Administrator\Desktop\modified_access_log.log文件是我的网站访问日志，请先对少量日志分析识别URL、IP、UA等关键字段，然后再分析全量日志生成一份精美的HTML网站日志分析报告。

合同智能审核

法务使用AiPy自动分析合同不利条款及修改建议，需要选择AI合同审核智能体，提示词：

C:\User\Administrator\Desktop\任务素材\服务器采购合同.docx 帮我分析下这个合同中有哪些对甲方不利的条款，将不利条款和建议修改内容分别列出来。

发票验真

财务使用AiPy批量做发票验真并整理为表格，需要选择发票识别验真智能体，提示词：

C:\Users\Administrator\Desktop\任务素材\发票 文件夹中有几张发票，请帮我查询下这几张发票是否是真实有效的发票，并帮我把发票关键信息列个表格出来

多资源调研报告

采购使用AiPy自动进行市场调研生成调研分析报告，注意勾选联网搜索智能体，提示词：

老板让我调研下市面上的数据分析系统，请帮我联网搜索一下今年最火最好用的数据分析系统，把系统名称、厂商、优势、不足、费用等信息整理为一个报告供我参考。

生成分析报表

销售运营人员使用AiPy自动进行数据分析生成分析报表，提示词： 我是一家3C家电全国连锁品牌的销售负责人，请帮我分析这份各门店销售情况汇总数据。

1、文件路径："C:\AiPyPro\resources\app.asar.unpacked\resources\demo\3c_sales.xlsx"

2、文件内容:表头分别为：orderid_date、product_category、product_name、brand、unit_price、quantity、total_amount、payment_method、customer_gender、customer_age_group_promotion、store_location、sales_time_salespers_on

3、分析内容：编写一份HTML门店销售分析报告，包括总销售额、产品销售分布、促销情况、门店销售排名、顾客画像、销售员情况、是否存在薅羊毛的情况、对未来的销售策略调整的优化建议等。

4、分析规则：分析前，请先读取前30行，了解数据格式然后根据具体数据格式编写合适的分析脚本进行分析。

5、报告保存到当前工作目录。

生成思维导图

领导使用AiPy阅读材料生成思维导图，需要先选择思维导图智能体，使用以下提示词：

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

研发系统demo

研发使用AiPy自动开发车辆管理系统demo，需要选择编程能力较强的大模型，比如GLM4.5，提示词如下：

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