配置和使用 AI

新建 Agent

通过编辑器“AI”入口创建 Agent，系统自动生成“会话表”、“消息表”等数据模型，详见AI数据模型说明。

设置模型参数

• 大模型：可选 Zion 或自有模型
• 随机性 (Temperature)：0-1，值越大越随机
• 最大轮数：每会话最大对话轮数
• 每轮 token 上限：超出则本轮失败
• 图片处理模式：分简单/精细，精细消耗更高

多轮对话时历史消息会累积，需合理设置 token 上限与轮数

设置输入

输入用于调用 Agent 时传入动态数据，可被预置提示、知识库引用（其中图片入参不能被提示词引用）。

添加预置提示

• 任务角色：定义 Agent 角色
• 任务详情：定义执行任务内容
• 任务限制：限制条件，如字数、风格、关键词等

配置知识库

知识库结果与预置提示一同发送给 Agent，提升专业性与实时性。

• 可选 Zion 数据库、API、本地上传
• 支持数据限额、过滤、排序、去重
• 上传支持 Word、PDF、txt、md，单文件≤50MB

RAG 相关请见[向量化存储与排序]

配置工具调用

可将行为流、API、其他 Agent 作为工具，AI 会自动判断是否调用。

输出配置

• 纯文本：不限结构，支持流式输出
• 结构化：按 JSON 结构输出，字段可自定义描述

调试

配置完成后可直接调试，检查输入、工具调用与返回结果。

调用 Agent 相关行为

在页面中使用 Agent 时，可通过“开始会话”、“继续会话”、“删除会话”、“停止回复”等行为与 Agent 交互。

1. 开始会话：创建新会话并发送初始消息，用于开启多轮或一次性 AI 对话。调用成功后返回会话 ID 和大模型结果，并在“会话表”与“消息表”中添加记录。

   • 入参配置：agent ID、消息内容
   • 输出结果：
     • id：新建会话的 ID
     • data：大模型返回的结果内容

2. 继续会话：向已有会话发送新消息

   • 入参配置：会话 ID、消息内容
   • 输出结果：无直接输出结果，但会话状态更新为“IN_PROGRESS”，并在“消息表”中添加新消息记录。

3. 删除会话：删除指定会话及其消息记录

   • 入参配置：会话 ID
   • 输出结果：无直接输出结果，但会话及其关联消息被删除

4. 停止回复：在会话未结束时停止 AI 回复，之后仍可继续会话

   • 入参配置：会话 ID
   • 输出结果：无直接输出结果，但会话状态变为已停止

运行 Agent 时，系统默认开启了加载动画，可用行为上的配置“请求时显示加载动画”来控制开或关。

使用 Agent 返回结果

1. 纯文本模式

页面添加页面变量，按钮行为配置 AI 请求，成功时设置页面变量为结果内容。
如果开启了流式输出，需要将流式的内容赋值给一个文本类型的页面变量，它的值会随着 AI 的输出而更新。

2. 结构化模式

配置自定义输出时，需设置输出字段类型与英文名称，AI 会按字段名返回结果。
调用时可在结果数据中选择字段内容进行业务判断。