配置和使用 AI

Zion 内置 AI 能力，开发者可创建高度定制化的 Agent，灵活定义 Prompt、RAG、工具调用等，结合 Zion 的前端编排与后端数据处理，快速搭建商业级 AI 应用。

模型支持

可使用 Zion 提供的大模型，也可接入自有模型服务。

使用 Zion 提供的模型

目前支持 GPT 4o 、deepseek 和 GPT 4o mini 等多种模型。按 token 消耗量计费，图片处理时 mini 的 token 消耗量约为 4o 的 33 倍。

可用 Point 计算器估算消耗量。

AI Point 不足时将无法正常进行数据向量化、排序及 Agent 调用。充值后需等待几分钟生效。

可在项目详情查看 Points 消耗记录。

每月月初系统赠送 50,000 AI Points，月底清零。

使用自有模型服务

付费项目可接入 DeepSeek、智谱等主流大模型，也支持自部署（仅 DeepSeek）。

支持模型

配置说明

• 填写名称、类型、平台、型号等基本信息
• 平台类需填写 API Key、接入点 ID（如火山方舟）
• 自部署需填写服务器 URL、鉴权 Header、模型值
• 验证通过后保存并部署即可使用

创建 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 相关行为

Zion 提供 5 种 Agent 相关行为：

开始会话

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

创建会话后，系统会自动向大模型发送一次请求。该行为的结果数据中，id 表示新建的会话的 id，data 表示大模型的返回结果。

继续会话

继续给 Agent 发送消息，需绑定“开始会话”返回的会话 ID。

删除会话

删除会话及其关联的消息、内容、工具调用记录。

停止回复

会话未结束时可触发“停止回复”，之后仍可继续会话。

使用 Agent 返回结果

纯文本模式

页面添加页面变量，按钮行为配置 AI 请求，成功时设置页面数据为结果内容。

如果开启了流式输出，需要将流式的内容赋值给一个文本类型的页面变量，它的值会随着 AI 的输出而更新。

结构化模式

配置自定义输出时，需设置输出字段类型与英文名称，AI 会按字段名返回结果。

调用时可在结果数据中选择字段内容进行业务判断。

注意事项

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