Y-Agent Studio

快速开始

这里将提供一些简要的使用说明和入门例子,帮助您快速上手Y-Agent框架

下载与启动

建议使用启动器方式

1.使用Y-Agent-launch启动器

使用Y-Agent-launch启动器,快捷方便,无需复杂配置,同时不会影响本机Python环境。

Gitee下载链接

Github下载链接

下载完成后,解压缩,然后双击 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、讨论模式加 工具和角色节点混合编排

这一节里,我们将设计一个更加复杂的流程,主要展示以下两点:

  1. 多Agent协作,以及流程混排
  2. 将工具作为节点,并且手工指定变量作为参数

由于之前使用了聊天室作为消息传递中心,这我们换一个,使用工作空间变量存储消息。

例子7、使用视觉模型

使用视觉模型非常简单:

在模型管理菜单,添加一个支持视觉的大模型,例如智谱4V。

添加一个大模型节点,选择视觉模型,并设置参数即可,如下图。

例子8、接入外部 WebApi 和 MCP

本框架可以方便的与您原有的系统集成,只需要将您的接口作为WebApi,并返回json数据即可。

相关知识:接入外部系统. 接入MCP.

进阶知识

分身.

聊天室概念. 聊天室消息用法.

执行器. 分批处理.

提示词编写. 编辑系统内置提示词.

添加测试. 创建并执行测试计划.

添加训练语料.

添加知识库: 文档知识库. Excel知识库.

在流程中显示引用文档.

对回答内容评分.

用户管理. 角色管理. 权限管理.

系统设置.

高阶知识

创建自动化流程分析工具.

自动添加测试.

自动添加训练语料.

自动添加文档知识库.

How is this guide?

最后更新

京ICP备2025145222号-1     © Copyright 向量感知(北京)智能科技有限公司 YAFO 2025.