快速开始
这里将提供一些简要的使用说明和入门例子,帮助您快速上手Y-Agent框架
下载与启动
建议使用启动器方式
1.使用Y-Agent-launch启动器
使用Y-Agent-launch启动器,快捷方便,无需复杂配置,同时不会影响本机Python环境。
下载完成后,解压缩,然后双击 Y-Agent-launch.exe
启动程序。
首次启动项目,会自动创建Python嵌入式虚拟环境,并自动下载依赖,请耐心等待。
如需更复杂设置,可以使用源码方式
2.从源码安装启动
从Git仓库下载
Gitee下载链接
git clone https://gitee.com/yafo-ai/y-agent.git
Github下载链接
git clone https://github.com/yafo-ai/y-agent.git
运行以下命令 创建conda环境
conda create --name y-agent python=3.11.8
启动conda环境
conda activate y-agent
安装依赖(注意命令所在目录)
cd y-agent
pip install -r requirements.txt
启动项目
python main.py
系统配置
系统首次启动需要添加大模型 在左侧菜单中找到模型配置,进入后展示系统已经配置的所有模型,单击新增按钮,来新建一个新的模型。
如果需要使用RAG系统,请设置向量数据库。 点击右上角系统设置,进入后选择向量数据库配置,支持多种向量数据库,选择其中一种进行配置。
如果需要,可以进入知识库管理,添加一个知识库。并创建文章。
案例教程
一些入门教程,帮助您快速上手
以下例子均包含在,系统预设的演示案例中,您可以直接查看。
接下来我们将从简单的例子开始,一些复杂的流程也仅仅是这些简单例子的组合。
例子1、接受和发送消息
作为第一课,我们先构建一个非常简单的流程,接受用户输入,然后发送消息给用户。
如果模型输出格式错误,请加上提示词 注意:工具指令不可篡改,不可遗漏,必须以command=|<|开始,以|>|结束。
。
例子2、简单的真心话游戏
真心话游戏的规则:有两个玩家,玩家A
和 玩家B
玩石头剪刀布,胜利者提问失败者回答问题,然后下一轮。
为了流程更加清晰,我们引入一个额外的角色: 裁判
例子3、为角色配置工具
上面学习了如何创建角色,并进行角色间合作完成任务,接下来我们学习如何让角色使用工具。
例子4、使用ReAct
ReAct(多轮推理)是Y-Agent框架的内置工具,适用于多跳问题,例如:541除以154 和 741除以211 谁更大?
例子5、使用变量
通过上面的学习,您已经掌握了基本的流程,接下来,我们开始使用变量。 相关知识:工作空间变量. 角色变量.
我们用一个成语接龙的例子,来演示变量的使用。
例子6、讨论模式加 工具和角色节点混合编排
这一节里,我们将设计一个更加复杂的流程,主要展示以下两点:
- 多Agent协作,以及流程混排
- 将工具作为节点,并且手工指定变量作为参数
由于之前使用了聊天室作为消息传递中心,这我们换一个,使用工作空间变量存储消息。
例子7、使用视觉模型
使用视觉模型非常简单:
在模型管理菜单,添加一个支持视觉的大模型,例如智谱4V。
添加一个大模型节点,选择视觉模型,并设置参数即可,如下图。
例子8、接入外部 WebApi 和 MCP
本框架可以方便的与您原有的系统集成,只需要将您的接口作为WebApi,并返回json数据即可。
进阶知识
分身.
系统设置.
高阶知识
How is this guide?
最后更新