YssAgent 可视化智能体构建平台
帮助中心

YssAgent 使用说明书

一站式可视化 AI 智能体搭建平台——拖拽连线即可构建对话机器人、知识库问答与自动化工作流。本指南覆盖从登录到部署的完整操作流程。

立即使用

一、快速开始

1. 访问与登录

  1. 打开浏览器访问官网 https://yssagent.com/,点击「立即使用」进入控制台;或直接访问 https://yssagent.com/app/
  2. 在登录页输入用户名密码登录(账号由管理员分配)。
  3. 登录后进入「我的流程」主页面。
提示:如果页面显示的还是旧版英文界面,多为浏览器缓存所致,按 Ctrl+F5 强制刷新即可。

2. 五分钟跑通第一个对话机器人

  1. 主页面点击右上角「新建流程」。
  2. 选择模板 「基础提示」(最简单的对话)或 「简易智能体」
  3. 进入画布后,先配置模型密钥(见第三章),否则无法运行。
  4. 点击右上角 运行 / Playground,在弹出的对话窗口里输入问题,即可对话。

二、界面概览

区域说明
我的流程所有已创建流程的列表,可新建、复制、导出、删除
起始项目 / 模板平台内置的 30+ 中文模板,可一键套用
画布(Flow 编辑器)拖拽组件、连线搭建流程的主工作区
左侧组件面板按分类罗列所有可用组件(输入/输出、模型、智能体、向量库等)
Playground测试与调试流程的对话/运行窗口
设置模型提供商、API 密钥、环境变量、快捷键、语言等

三、配置模型提供商(重要)

运行任何流程前,必须先填入对应大模型厂商的 API 密钥,否则会报错。

配置步骤

  1. 进入 设置 → 模型提供商 / 配置模型提供商
  2. 选择厂商(如 DeepSeek、Kimi、智谱 GLM、OpenAI/第三方等)。
  3. 粘贴该厂商的 API Key,点击 检查并保存
  4. 保存成功后,该厂商下的模型即可在流程的「模型」组件里选择。

已内置的模型厂商与模型

  • DeepSeek:deepseek-chat(默认)、deepseek-reasoner
  • Kimi(月之暗面):kimi-k2-0905-preview(默认)、kimi-latest、kimi-thinking-preview、moonshot-v1 系列等共 12 款
  • 智谱 GLM:glm-4.6(默认)、glm-4.5/air/x/flash、glm-z1 推理系列等共 16 款
  • 第三方/OpenAI 兼容:gpt-4o(默认)、gpt-4.1 系列、o3/o1 推理系列、Claude、Gemini、Qwen 等共 24 款
各厂商 API Key 获取地址请到对应官网控制台申请(DeepSeek 开放平台、Moonshot 平台、智谱开放平台等)。

四、搭建流程(核心操作)

1. 添加组件

从左侧组件面板拖拽组件到画布。常用组件:

  • 聊天输入 / 聊天输出:对话的入口与出口
  • 模型 / 语言模型:调用大模型
  • 提示词(Prompt):设定角色与指令
  • 智能体(Agent):能自主规划、调用工具的核心组件
  • 知识库 / 向量库:实现资料检索问答(RAG)

2. 连线

拖动组件右侧的输出端口到下一个组件的输入端口,建立数据流向。典型链路:聊天输入 → 提示词 → 模型 → 聊天输出

3. 运行与调试

  • 点击单个组件上的 运行 可单独执行并查看输出。
  • 点击右上角 Playground 进入完整对话测试。
  • 出错时组件会标红,点开可看错误详情。

五、知识库问答(RAG)

让机器人基于你自己的资料回答问题。

  1. 套用模板 「向量库 RAG」「知识库」
  2. 在「知识库 / 添加知识库」中上传文档(PDF、TXT、DOC、DOCX、MD 等)。
  3. 设置分块大小分块重叠,并选择嵌入模型(需配置对应密钥)。
  4. 运行流程,机器人即可结合资料内容作答。

六、模板库

平台内置 30+ 中文模板,开箱即用,例如:

  • 对话类:基础提示、记忆聊天机器人、简易智能体、研究智能体
  • 知识库类:向量库 RAG、混合检索 RAG、文档问答、知识库
  • 内容创作:博客写手、Instagram 文案助手、Twitter 推文串生成器、SEO 关键词生成器
  • 数据分析:市场调研、财报解析器、文本/图像情感分析、YouTube 分析
  • 自动化:社交媒体智能体、优惠比价助手、新闻聚合器、旅行规划智能体、会议纪要

在「模板」入口选择后点击使用,即可复制到自己的流程中再修改。

七、进阶功能

版本历史

流程编辑器内可 保存版本、查看 版本历史恢复导出 历史版本,避免误改丢失。

部署与对外接口

  • 在「部署」中可将流程发布,供生产环境调用。
  • 通过 API 访问 获取调用端点;通过 嵌入网站 把对话框嵌入到自己的网页。

MCP 服务器

可将项目中的流程作为 MCP 工具 暴露给 Cursor、Claude 等客户端调用;也可添加外部 MCP 服务器扩展能力。

多模态与语音

支持图片、音频等输入;在对话框中可使用 语音输入(需配置 OpenAI / ElevenLabs 密钥)。

八、常见问题(FAQ)

Q:保存模型密钥时报错 / 配置保存失败?
A:已修复(此前为加密密钥格式问题)。如仍遇到,请刷新后重试,并确认 Key 粘贴完整、无多余空格。
Q:界面还是英文?
A:浏览器缓存问题,Ctrl+F5 强制刷新;仍不行可清除站点缓存。
Q:运行流程报错"未配置模型提供商 / No Model Provider Configured"?
A:先到 设置 → 模型提供商 填入并保存对应厂商的 API Key。
Q:上传文档没反应?
A:确认文件格式受支持(PDF/TXT/DOC/DOCX/MD 等),单次只上传受支持类型。
Q:流程跑一半停了?
A:查看标红组件的「错误详情」,常见原因是密钥无效、额度不足或必填字段为空。

本说明书对应当前线上已汉化版本。如平台升级,部分入口名称可能略有变化。