ANDFlow 工作流平台用户使用说明
本文档面向所有 ANDFlow 用户，说明当前平台中实际可见、可操作的主要功能。用户可以按照本文档完成统一登录、创建和编辑 Agentflow、导入或导出工作流、配置模型凭证、运行调试、使用模板与技能，以及发布和管理受保护的工作流 API。
当前版本以 Workbench 作为主要工作入口，以 Agentflow 作为核心流程类型。旧版或非主入口能力如果没有在当前界面中直接呈现，本文档不作为重点展开。
1. Workbench 工作台
从 CogniAND 主站进入 ANDFlow 后，系统会验证主站登录状态并进入 Workbench 工作台。当前前端采用简化布局，主要操作集中在顶部导航栏、左侧历史浮窗、中间画布、右侧节点配置面板和右上角对话面板中。
顶部导航栏包含以下入口：
| 区域 | 功能 |
|---|---|
| ANDFlow 标识 | 返回 Workbench 主页或当前主要工作区 |
| Backstage | 进入后台配置区，管理 Credentials & API Keys、Market、Skills、Tools、Execution |
| 使用引导按钮 | 重新启动遮盖式新手引导 |
| 深色模式开关 | 切换浅色/深色界面 |
Workbench 中的主要区域如下：
| 区域 | 说明 |
|---|---|
| 左侧历史浮窗按钮 | 位于窗口左侧垂直中央，点击后打开历史项目列表 |
| 历史项目浮窗 | 展示 Your history、项目搜索、项目打开、发布 API、更多操作、账号设置和退出登录 |
| 顶部标签栏 | 展示当前打开的 Agentflow 项目标签，可以新增或关闭标签 |
| 中央画布 | 编辑 Agentflow 节点和连线 |
| 右侧画布工具栏 | 提供缩放、添加节点、背景开关等画布操作 |
| 右侧节点配置面板 | 点击节点后出现，用于配置节点参数和查看 Run Data |
| 右上角保存/生成/检查/消息按钮 | 保存流程、生成流程、查看校验、打开对话测试面板 |
1.1 统一登录
公网版本的 ANDFlow 使用 CogniAND 主站账号体系：
- 用户从 CogniAND 主站点击 ANDFlow 入口。
- 如果尚未登录，系统先跳转到 CogniAND 登录页面。
- 登录或注册成功后，主站生成一次性登录凭据并返回 ANDFlow。
- ANDFlow 根据主站账号准备对应的用户、工作区和权限，然后进入 Workbench。
用户不需要在 ANDFlow 中重复注册。直接访问 ANDFlow 公网地址但没有有效登录状态时，也会返回 CogniAND 完成登录。登录链接具有时效性；如果页面提示链接失效，请重新从主站的 ANDFlow 入口进入。
本地开发或私有部署可能启用独立登录方式，其登录入口和账号由部署管理员提供。
2. 核心概念
2.1 Agentflow
Agentflow 是 ANDFlow 当前主要的工作流类型。它用于把多个 AI 节点、工具节点、条件判断、人工输入、循环和多角色协作节点组合成一条可执行流程。
Agentflow 适合以下场景：
- 构建一个可以对话运行的智能体流程。
- 将用户输入传给 LLM，并把回答返回给用户。
- 让 Agent 根据任务自动调用工具。
- 通过 Condition、Loop、Iteration 实现分支和循环。
- 通过 HTTP、Tool、Custom Function 连接外部系统。
- 通过 Supervisor、Worker、Human 节点组织多角色协作。
- 将流程保存为历史项目，后续继续编辑、运行或发布 API。
2.2 节点
节点是 Agentflow 的基本单元。每个节点负责一个具体动作，例如接收输入、调用模型、调用工具、判断条件、执行函数、请求外部接口或返回结果。
当前 Agentflow 节点列表主要按以下分组展示：
| 分组 | 常见节点 | 用途 |
|---|---|---|
| 基础节点 | Start、Human Input、Sticky Note | 定义入口、等待人工输入、给画布添加说明 |
| Intelligent Roles | Agent、LLM、Condition Agent | 调用语言模型或创建具备判断/工具能力的智能角色 |
| Control | Condition、Loop、Direct Reply、Iteration | 控制流程走向、循环执行、直接回复结果 |
| Tools | Tool、HTTP、Execute Flow、Custom Function | 调用工具、请求接口、执行子流程或自定义函数 |
| Multi-group | Supervisor、Worker、Human | 构建多角色协作流程，同有场景这三类节点协同出现，适配多角色协作场景 |
2.3 连线
连线表示节点之间的数据流和执行顺序。通常从上游节点右侧输出端口拖动或点击到下游节点输入端口。当前版本还支持从 Start 节点右侧出端口快速打开节点列表，选择 LLM 后自动创建并连接。
2.4 Credential
Credential 用于保存第三方服务密钥，例如模型 API Key、外部工具密钥、数据库连接信息或 OAuth 授权。Credential 统一保存在 Backstage 或 Credentials 页面中，节点配置时可以选择已保存的 Credential。
2.5 API Key
平台 API Key 用于标识获得授权的服务端调用方。它与 LLM 节点使用的模型 Credential 不同：模型 Credential 用于连接模型或第三方服务，平台 API Key 用于调用已经发布的 ANDFlow 流程。
历史项目列表中的云上传图标 Publish as API 可将流程发布为 slug API。生产环境中的调用还可能要求主站后端代理、共享密钥或请求签名；不要把平台 API Key、共享密钥或完整运行地址写入游戏前端、网页脚本或公开仓库。
2.6 Run Data
Run Data 是节点级运行数据。运行 Agentflow 后，点击某个节点并切换到右侧面板的 Run Data，可以查看该节点在某一轮对话中的输入、输出、执行状态和调试信息。
3. 推荐的新手路径
第一次使用建议按以下顺序建立最小 Start -> LLM 工作流：
- 从 CogniAND 主站进入 ANDFlow，完成统一登录并进入 Workbench。
- 点击顶部的
使用引导按钮，跟随遮盖式引导熟悉界面。 - 在 Start 节点右侧出端口添加一个 LLM 节点。
- 保存项目并输入清晰的项目名称。
- 打开左侧历史浮窗，确认项目出现在
Your history中。 - 进入 Backstage，了解 Credential 和 API Key 的配置位置，并配置属于自己的 API Key。
- 回到 Workbench，打开历史项目。
- 点击 LLM 节点，在右侧 Properties 中配置模型、凭证和提示词。
- 点击右上角消息按钮，输入测试内容并发送。
- 运行后点击节点，查看右侧
Run Data。
4. Workbench 使用说明
4.1 打开历史项目浮窗
左侧窗口边缘垂直中央有一个细长按钮。点击后，会从左侧展开历史项目浮窗。
历史项目浮窗包含：
| 功能 | 说明 |
|---|---|
| ANDFlow 标题 | 当前工作台标识 |
| Search | 按项目名称搜索历史 Agentflow |
| Your history | 当前账号和工作区下的历史项目列表 |
| 项目名称 | 点击项目名称可加载该项目到画布 |
| 节点小图标 | 展示该项目中出现的主要节点类型 |
| Publish as API | 将该项目发布为可调用 API |
| More | 打开更多项目操作，例如导出工作流、导出数据等 |
| Help Center | 帮助中心入口；具体内容以当前部署提供的帮助资源为准 |
| Settings | 进入账号设置 |
| Sign out | 退出登录 |
| 用户信息 | 显示当前账号名称或邮箱 |
历史浮窗右侧边缘还有一个收起按钮，点击后浮窗会关闭。
4.2 打开历史项目
- 点击左侧历史浮窗按钮。
- 在
Search中输入项目名称，或直接在Your history中浏览。 - 点击项目行。
- 系统会将项目加载到当前 Workbench 标签中。
- 画布会显示该项目保存时的节点和连线。
如果列表中没有项目，请确认：
- 当前账号是否已经登录。
- 当前工作区是否正确。
- 项目是否已经保存过。
- 搜索框是否输入了过滤关键词。
4.3 新增或切换项目标签
Workbench 顶部有项目标签栏。每个打开的项目会显示为一个标签。
常用操作：
- 点击标签切换正在编辑的项目。
- 点击标签中的关闭按钮关闭该项目标签。
- 点击标签栏右侧加号创建新流程标签。
- 未保存的新流程通常显示为
Untitled或类似名称。
建议一次只编辑少量项目，避免误把节点配置写入错误标签。
5. 画布操作说明
5.1 画布右侧工具栏
画布右侧垂直工具栏包含以下按钮：
| 按钮 | 功能 |
|---|---|
| 放大镜加号 | 放大画布 |
| 放大镜减号 | 缩小画布 |
| 上传按钮 | 选择工作流 JSON，并用文件内容替换当前画布 |
| 圆形加号 | 打开 Add Node 节点列表 |
| 背景按钮 | 打开或关闭点状画布背景 |
| Fit View | React Flow 默认视图按钮，用于让画布内容适配视口，具体显示取决于当前版本样式 |
当前版本已去掉网格吸附按钮和网格吸附功能。移动节点时不会强制吸附到固定网格。
5.2 添加节点
有两种常用方式添加节点。
方式一：从 Start 出端口快速添加
- 找到 Start 节点。
- 将鼠标移动到 Start 节点右侧。
- 点击右侧蓝色出端口。
- 在弹出的节点列表中选择
LLM。 - 系统会自动在 Start 右侧创建 LLM 节点，并建立连线。
方式二：从右侧工具栏添加
- 点击画布右侧工具栏中的圆形加号。
- 打开
Add Node面板。 - 在搜索框输入节点名称，例如
LLM、Agent、HTTP。 - 点击或拖拽节点到画布。
- 手动连接节点端口。
添加节点时建议先搭建最小可运行流程：
Start -> LLM确认最小流程能保存和运行后，再继续添加 Direct Reply、Tool、Condition、Loop 等节点。
5.3 连接节点
连接节点通常有以下规则：
- 从上游节点的输出端口连接到下游节点的输入端口。
- Start 通常作为整个流程的起点。
- LLM、Agent、Tool、HTTP 等节点通常接收上游输入后产生输出。
- Condition、Loop、Iteration 等节点可能有特殊端口或分支，需要按照节点配置项继续设置。
- 如果连线后节点没有执行，请检查是否有必填配置未填写。
5.4 移动画布和节点
常用操作：
| 操作 | 说明 |
|---|---|
| 拖动画布空白处 | 平移画布 |
| 鼠标滚轮或右侧缩放按钮 | 缩放画布 |
| 拖动节点 | 移动节点位置 |
| 点击节点 | 打开右侧节点配置面板 |
| 选中节点或连线后按 Delete | 删除节点或连线 |
| 背景按钮 | 显示或隐藏点状背景 |
删除节点前，请确认下游节点是否依赖它的输出。删除上游节点可能导致整条流程断开。
6. 保存和命名项目
首次保存项目时需要输入项目名称。
操作步骤：
- 在画布左上角点击保存按钮。
- 弹出保存对话框。
- 在输入框中输入项目名称。
- 点击
Save。 - 保存成功后，项目会进入历史列表。
命名建议：
- 使用场景目标命名，例如
囚徒困境、多臂老虎机。 - 如果是测试项目，可以加日期或版本号，例如
LLM测试-0601。 - 避免长期使用
Untitled，否则历史列表中不容易识别。
保存后再次点击保存，会更新当前项目。运行对话前建议先保存一次，否则打开消息面板时会提示先保存项目。
7. 配置节点
7.1 打开节点配置面板
点击画布中的节点后，右侧会出现节点配置面板。面板顶部有两个页签：
| 页签 | 作用 |
|---|---|
| Properties | 配置节点名称、模型、凭证、提示词、输入输出等参数 |
| Run Data | 查看该节点在最近运行中的执行数据 |
Properties 中可以编辑节点名称。点击名称旁的编辑按钮后输入新名称，点击确认保存。
7.2 配置 LLM 节点
LLM 节点通常用于调用语言模型。实际字段会根据节点定义和平台配置变化，但一般需要关注：
- 模型提供方或模型名称。
- Credential 或 API Key。
- 用户输入或上游输入的引用。
- System Prompt 或指令提示词。
- 输出格式，例如普通文本或结构化 JSON。
- Temperature、Max Tokens 等生成参数。
建议配置顺序：
- 先在 Backstage 中创建模型 Credential。
- 回到 Workbench，点击 LLM 节点。
- 在 Properties 中选择对应 Credential。
- 选择模型。
- 填写提示词。
- 保存项目。
- 使用消息面板测试。
7.3 常用节点说明
| 节点 | 说明 | 常见用途 |
|---|---|---|
| Start | 流程入口 | 接收用户输入或初始变量 |
| LLM | 调用语言模型 | 生成、总结、分类、提取、问答 |
| Agent | 可调用工具的智能体 | 复杂任务、工具调用、多步骤推理 |
| Condition Agent | 带智能判断的分支角色 | 根据语义或条件决定后续路径 |
| Condition | 条件分支 | 根据字段、状态或表达式走不同路径 |
| Direct Reply | 直接回复 | 返回固定文本或上游结果 |
| Loop | 循环执行 | 重复处理直到满足条件 |
| Iteration | 迭代处理 | 对列表或多条数据逐项处理 |
| Tool | 调用工具 | 调用平台内置或自定义工具 |
| HTTP | 调用外部接口 | 请求业务系统、Webhook、第三方 API |
| Execute Flow | 执行另一个流程 | 复用已有 Agentflow |
| Custom Function | 自定义函数 | 字段处理、格式转换、简单计算 |
| Human Input | 人工输入 | 流程中等待人工确认或补充信息 |
| Supervisor | 协调角色 | 面向心理学场景，人机交互实验中，多 Worker 协作中的调度者 |
| Worker | 执行角色 | 面向心理学场景，人机交互实验中，多角色流程中的具体执行者 |
| Human | 人类角色 | 面向心理学场景，人机交互实验中，多角色流程中代表人工参与者 |
| Sticky Note | 注释 | 给画布添加说明，不参与执行 |
8. Backstage 后台配置区
点击顶部导航栏中的 Backstage 进入后台配置区。Backstage 左侧是功能导航，当前主要包括：
| 菜单 | 说明 |
|---|---|
| Credentials & API Keys | 管理第三方 Credential 和平台 API Key |
| Market | 浏览、预览、下载或使用工作流模板 |
| Skills | 管理已安装技能并从 Skill Square 安装技能 |
| Tools | 管理可被 Agentflow 调用的工具 |
| Execution | 查看执行记录、导出数据并管理 slug API |
| Back to Workbench | 返回 Workbench |
8.1 Credentials & API Keys
Credentials & API Keys 页面中包含两个区域：Credentials 和 API Keys。
Credentials 区域用于保存第三方集成密钥。页面中可以：
- 搜索 Credential。
- 点击
Add Credential新建 Credential。 - 查看 Credential 名称、更新时间和创建时间。
- 编辑或删除已有 Credential，具体权限取决于账号角色。
API Keys 区域用于管理外部调用 ANDFlow API 的密钥。页面中可以：
- 搜索 API Key。
- 点击
Create Key创建新 API Key。 - 点击
Import导入 API Key JSON。 - 复制 API Key。
- 显示或隐藏 API Key 明文。
- 查看某个 API Key 关联了多少流程。
- 编辑或删除 API Key，具体权限取决于账号角色。
8.2 配置模型 API Key 的推荐流程
如果你要让 LLM 节点调用模型，通常需要先配置模型 API Key。
推荐步骤：
- 点击顶部
Backstage。 - 在左侧点击
Credentials & API Keys。 - 在 Credentials 区域点击
Add Credential。 - 选择对应模型或服务的 Credential 类型。
- 输入名称和 API Key。
- 保存 Credential。
- 点击
Back to Workbench或顶部 ANDFlow 返回 Workbench。 - 点击 LLM 节点。
- 在 Properties 中选择刚创建的 Credential。
- 保存项目并运行测试。
安全建议：
- 不要把 API Key 写进节点提示词、节点名称或项目名称。
- 不要在截图、导出的 JSON 或公开文档中暴露 API Key。
- 如果怀疑密钥泄露，应在第三方平台立刻作废并重新创建。
8.3 Market
Market 用于浏览和复用平台提供的工作流模板。页面根据模板用途分为：
| 分类 | 说明 |
|---|---|
| Community Templates | 通用工作流模板，例如知识问答、客服分流、会议总结、研究摘要、数据分析、API 集成和人工审核流程 |
| Psych Experiments | 心理学实验工作流，例如 Stroop、Go/No-Go、N-back、Iowa Gambling、Ultimatum Game 和 Flanker 等范式 |
| My Templates | 当前用户或工作区保存的自定义模板；是否显示取决于账号权限 |
Community Templates 和 Psych Experiments 均支持按用途筛选以及卡片或列表视图。模板卡片中的节点图标用于快速展示该模板包含的主要节点类型。
常见用法：
- 进入 Backstage。
- 点击
Market。 - 选择
Community Templates或Psych Experiments，浏览或筛选模板。 - 点击模板卡片进入预览画布，检查节点、连线、Sticky Note 和提示词结构。
- 点击
Download JSON将模板保存为 JSON 文件，或点击Use Template导入 Workbench。 - 在 Workbench 中检查模型、Credential、工具和外部接口配置，然后保存为自己的项目。
模板提供的是可编辑范本。模板中的模型、Credential、API 地址或业务参数可能需要根据当前账号和部署环境重新配置。
8.4 Skills
Skills 用于管理可复用的技能包，页面包含两个区域：
| 区域 | 说明 |
|---|---|
| Installed | 查看当前已安装技能，新建或上传技能，并进行查看、暂停、恢复和删除 |
| Skill Square | 搜索平台提供的技能卡片，并安装到当前环境 |
在 Installed 中点击 New Skill 可以创建技能。上传技能包时，应确保包内说明、文件结构和依赖来源可信。暂停技能后，该技能仍保留在列表中，但不会作为正常启用的技能使用；需要时可以恢复。
从 Skill Square 安装技能后，页面会返回 Installed，用户可以查看技能说明、Markdown 内容和包内文件。技能能否被具体 LLM 或 Agent 节点使用，还取决于节点类型、账号权限和当前部署配置。
8.5 Tools
Tools 用于管理 Agentflow 可调用的工具。工具可以被 Agent 或 Tool 节点调用。
常见用法：
- 创建一个工具，用于调用内部接口。
- 创建一个工具，用于执行固定函数。
- 将工具绑定到 Agent 节点，让 Agent 在运行时自动选择是否调用。
- 测试工具输入输出是否符合预期。
设计工具时建议明确：
- 工具名称是否清晰。
- 参数字段是否简洁。
- 返回结果是否稳定。
- 错误信息是否便于 Agent 理解。
8.6 Execution
Execution 用于查看已保存或已发布流程的运行记录、导出实验数据，以及管理已经注册的 slug API。它主要服务于正式运行后的排查、分析和审计。
你可以在这里关注：
- 按工作流查看执行记录、调用时间、状态和会话。
- 打开某次执行，检查流程输入、节点输出和错误信息。
- 选择单条或多条执行记录进行数据导出。
- 按字段配置导出内容，并选择 Excel、CSV 或 JSON 格式。
- 查看已注册 slug 对应的工作流、有效期和启用状态。
- 对 slug 执行刷新、启用、停用或删除；部分操作支持批量处理。
如果只是 Workbench 中的即时对话测试，更推荐先看右侧节点面板中的 Run Data。如果流程已经发布给外部系统调用，或需要跨会话比较和导出数据，再使用 Execution。
执行记录可能包含用户输入、模型输出、实验变量或参与者数据。导出和分享前，应根据所属组织的隐私规则进行脱敏，并只选择完成分析所必需的字段。
9. 运行和测试 Agentflow
9.1 打开消息面板
Workbench 右上角有消息按钮。点击后会打开对话测试面板。
如果当前项目尚未保存，系统会提示：
保存项目 进入对话
当前流程尚未保存，请先保存项目后再开始对话。此时点击 保存项目，输入项目名称并保存，然后再打开对话面板。
9.2 输入测试内容
打开对话面板后，在底部输入框输入测试内容并发送。流程会从 Start 节点开始执行，依次运行后续节点。
测试建议：
- 第一次只输入一句简单内容，例如
你好，请用一句话介绍你能做什么。 - 如果 LLM 节点报错，优先检查 Credential 和模型配置。
- 如果没有输出，检查节点是否已经连接，是否存在未填写必填项。
- 如果流程有条件分支，尝试输入不同类型内容覆盖不同路径。
9.3 清空或展开对话
消息面板打开后，右上角附近会出现辅助按钮：
| 按钮 | 说明 |
|---|---|
| Clear Chat History | 清空当前对话历史 |
| Expand Chat | 展开更大的聊天窗口 |
清空历史前请确认是否还需要保留调试上下文。
10. 查看 Run Data
运行流程后，可以查看每个节点的运行数据。
操作步骤：
- 在画布中点击一个节点。
- 右侧出现节点面板。
- 切换到
Run Data页签。 - 在
Process Flow下拉中选择某一轮运行。 - 使用上一轮/下一轮按钮切换不同运行回合。
- 查看该节点的输入、输出、状态和原始数据。
Run Data 常用于回答以下问题：
- 这个节点有没有被执行。
- 上游传入的数据是什么。
- LLM 返回了什么。
- 工具调用是否成功。
- 条件分支为什么走到某一条路径。
- 哪个节点导致整条流程失败。
如果 Run Data 显示 Check the node data after running，说明当前还没有可查看的运行记录。请先通过消息面板运行一次。
如果显示 Node not executed in this round，说明该节点在当前选择的运行回合中没有被执行，可能是分支条件没有命中。
11. 发布为 API
历史项目列表中每个项目右侧有 Publish as API 按钮。点击后，可以将当前 Agentflow 发布并注册为带 slug 的运行 API。发布页面会展示请求方法、Endpoint、Full URL、有效期和当前状态。
发布前建议确认：
- 项目已经保存。
- 所有必填 Credential 已配置。
- 使用消息面板至少测试通过一次。
- 输出格式稳定。
- 不会返回敏感信息。
- 已确认调用方和服务端鉴权方式。
11.1 slug API 有效期
每个新建或刷新的 slug API 默认有效 48 小时：
- 到期后，slug 会被标记为已过期并停止接受运行请求。
- 需要继续使用时，在发布 API 页面或 Execution 的 slug 管理区域点击
刷新 48h。 - 刷新会重新启用该 slug，并从刷新时刻开始计算新的 48 小时有效期。
- 手动停用的 slug 不可调用；重新启用时会重新计算有效期。
- 不再使用的 slug 应及时删除，避免保留无效入口。
刷新 API 只延长运行入口的有效期，不会自动修改工作流节点、提示词或 Credential。工作流有重要改动时，应重新测试并确认已保存和发布的内容。
11.2 调用安全
公网部署中的运行 API 面向服务端集成，不建议由实验游戏或普通网页直接调用：
- 游戏前端先请求 CogniAND 主站后端。
- 主站后端检查登录状态、实验权限和请求参数。
- 主站后端携带平台约定的共享密钥或短时签名请求 ANDFlow。
- ANDFlow 校验 slug 状态、有效期和服务端凭据后执行工作流。
平台 API Key 可以在 Backstage 的 Credentials & API Keys 中管理，但生产部署还可能要求额外的服务端共享密钥或 HMAC 签名。Allowed Domains 和浏览器 CORS 主要限制浏览器来源，不能代替服务端鉴权。
不要在浏览器源代码、游戏前端、截图、公开文档或公开仓库中暴露 API Key、共享密钥、签名材料或可长期使用的运行地址。
12. 导出项目和数据
历史项目列表中点击 More 可以打开项目操作菜单，具体可见项取决于账号权限和部署配置。
当前菜单中的主要操作包括：
| 操作 | 用途 |
|---|---|
| Download Data | 打开数据导出面板，选择执行轮次、字段和导出格式 |
| Rename | 修改项目名称 |
| Duplicate | 复制当前工作流为新项目 |
| Export | 导出当前 Agentflow JSON，用于备份、迁移或分享工作流结构 |
| Save As Template | 将当前工作流保存到 My Templates |
| Allowed Domains | 配置允许嵌入或访问相关功能的域名；不能代替 API 服务端鉴权 |
| Delete | 删除当前工作流 |
12.1 Export 工作流
点击 Export 会下载包含节点、连线、视口和节点配置的 Agentflow JSON。该文件可以用于备份，也可以通过 Workbench 画布右侧的上传按钮重新导入。
12.2 上传工作流 JSON
上传步骤：
- 打开要接收工作流内容的 Workbench 标签。
- 点击画布右侧工具栏中的上传按钮。
- 选择由 ANDFlow 导出或符合 ANDFlow 工作流结构的
.json文件。 - 系统校验文件中是否包含有效的
nodes和edges，然后用上传内容替换当前画布。 - 检查节点、连线、提示词和配置，确认无误后点击
Save持久化修改。
上传会修改当前标签中的画布内容。导入前建议先导出或保存原工作流，避免覆盖尚未保存的修改。系统可以识别直接的工作流 JSON，以及包含 flowData 的部分 ANDFlow 导出结构。
12.3 Download Data
Download Data 用于导出流程执行数据。用户可以选择执行轮次或会话、配置需要的字段，并导出为 Excel、CSV 或 JSON。复杂实验可以按多个执行记录进行批量导出。
12.4 Save As Template
Save As Template 用于把当前工作流保存到 Market 的 My Templates，便于在同一工作区中重复使用。模板保存的是流程结构和配置范本，不会把第三方密钥作为可公开共享内容。
导出前请注意：
- 导出的 JSON 可能包含节点配置、提示词、流程结构等信息。
- 正常情况下 Credential 的密钥值应被系统保护，但仍不建议把导出文件公开传播。
- 执行数据可能包含用户输入、模型输出、实验变量或参与者信息。
- 如果项目包含业务敏感提示词、接口地址或个人数据，请按组织安全要求保存和脱敏。
13. 常见任务示例
13.1 创建一个最小 LLM 流程
目标：用户输入一句话，LLM 返回回答。
步骤：
- 进入 Workbench。
- 点击 Start 节点右侧出端口。
- 选择
LLM。 - 点击 LLM 节点。
- 在右侧 Properties 中选择模型和 Credential。
- 填写提示词，例如
请根据用户输入给出简洁回答。 - 点击保存按钮。
- 输入项目名称，例如
最小LLM测试。 - 点击消息按钮。
- 输入
请介绍 ANDFlow并发送。 - 查看输出。
- 点击 LLM 节点，切换到 Run Data 检查执行数据。
13.2 给流程添加直接回复
目标：在某些场景下直接返回固定内容。
步骤：
- 点击右侧工具栏圆形加号。
- 搜索
Direct Reply。 - 添加到画布。
- 将上游节点连接到 Direct Reply。
- 点击 Direct Reply 节点。
- 在 Properties 中配置返回内容或引用上游结果。
- 保存并运行测试。
13.3 调用外部 HTTP 接口
目标：流程中请求一个外部服务。
步骤：
- 点击右侧工具栏圆形加号。
- 搜索
HTTP。 - 添加 HTTP 节点。
- 在 Properties 中配置 URL、Method、Headers、Body 等参数。
- 如接口需要密钥，优先在 Backstage 创建 Credential，再在节点中引用。
- 将 HTTP 节点连接到后续 LLM 或 Direct Reply。
- 保存并运行测试。
- 在 Run Data 中检查请求和响应。
13.4 创建多角色流程
目标：用 Supervisor 协调多个 Worker。
步骤：
- 添加 Supervisor 节点。
- 添加一个或多个 Worker 节点。
- 根据流程需求添加 Human 节点。
- 配置 Supervisor 的任务说明和分派逻辑。
- 配置每个 Worker 的职责、模型和工具。
- 连接节点。
- 保存并运行多轮测试。
- 使用 Run Data 检查每个角色的执行结果。
14. 常见问题排查
14.1 登录后看不到历史项目
请检查：
- 是否使用正确账号登录。
- 当前工作区是否正确。
- 项目是否保存到了当前工作区。
- 左侧历史浮窗是否已打开。
- 搜索框是否过滤掉了项目。
- 后端服务是否正常运行。
如果从 CogniAND 进入后仍看不到项目，请确认当前主站账号是否已被分配到正确的组织和工作区。首次进入的新账号可能没有历史项目，这是正常情况。
14.2 点击消息按钮后要求先保存
这是正常行为。未保存项目没有稳定 ID，无法可靠记录对话和运行数据。请先点击保存按钮，输入项目名称并保存。
14.3 LLM 节点运行失败
优先检查：
- 是否已经配置对应模型 Credential。
- API Key 是否有效。
- LLM 节点是否选择了正确 Credential。
- 模型名称是否正确。
- 提示词是否引用了不存在的变量。
- 外部模型服务是否可用。
14.4 Run Data 为空
可能原因：
- 还没有运行过流程。
- 当前选择的运行回合没有执行该节点。
- 对话面板运行失败。
- 节点没有连入主流程。
请先运行一次流程，再查看对应节点的 Run Data。
14.5 发布 API 后外部调用失败
请检查：
- 项目是否已发布。
- slug 是否已过期、停用或删除；过期后需要手动刷新 48 小时。
- 请求地址和请求方法是否与发布页面显示的一致。
- 调用是否来自获准的主站后端代理，而不是直接来自游戏前端。
- 服务端是否携带部署要求的平台 API Key、共享密钥或 HMAC 签名。
- 服务端时间是否准确；短时签名超出允许时间窗口会被拒绝。
- 流程依赖的 Credential 是否仍然有效。
- Execution 中是否有失败记录。
14.6 找不到某个功能入口
当前前端是精简布局，传统左侧菜单已隐藏。优先使用：
- Workbench：编辑和运行 Agentflow。
- 顶部 Backstage：进入后台配置。
- 历史浮窗：打开、搜索、发布和导出项目。
- 顶部问号：启动使用引导。
部分高级功能会根据权限、开源/云端/企业配置或功能开关显示，不同部署看到的入口可能略有不同。
15. 使用建议
- 每完成一段节点搭建就保存一次。
- 先构建最小可运行流程，再逐步增加工具、条件和循环。
- 节点名称要表达业务含义，例如
意图识别 LLM、查询客户接口。 - 凭证统一放在 Backstage 管理，不要写进提示词或节点名称。
- 每次改动后用消息面板测试，并查看 Run Data。
- 发布 API 前至少完成一次成功测试。
- 复杂流程建议用 Sticky Note 标注关键设计意图。
- 多分支流程建议为每条分支准备测试输入。
16. 账号、工作区与权限
公网用户使用 CogniAND 主站账号进入 ANDFlow，不需要单独申请 ANDFlow 密码。主站注册、登录和账号安全设置均以 CogniAND 当前提供的功能为准。
用户进入 ANDFlow 后，只能访问其所属组织和工作区内获得授权的项目、模板、技能、Credential、工具和执行数据。不同账号看到的按钮或菜单可能不同，这是权限控制的正常结果。
如果需要加入新的组织、切换工作区、获得模板管理或 API 发布权限，请联系所属组织的管理员。不要共用账号，也不要在文档、聊天记录或截图中传播密码、API Key、登录 Cookie 或其他认证信息。