ZAI配置说明
功能说明
Z AI 是 Zion 内置在编辑器内的用来配置自定义 AI 请求的强大功能之一，它通过精简的交互设计让 AI 配置变得简单易懂，让您通过无代码的方式构建自己的专属 AI 应用成为可能。
核心功能
- 支持多种大模型，目前包括「 GPT 3.5 turbo」、「GPT 4.0 turbo」，未来支持更多大模型的直接接入
- 支持多种入参类型，目前包括文本与图片
- 支持多种知识库数据源，包括 Zion 数据库、第三方 API 以及本地上传
- 支持多种工具调用选择，包括行为流、API、已配置的其它 AI 请求
- 支持 JSON 格式化输出、流式输出# 应用场景
AI 应用场景非常多，以下是一些常见的应用场景，你可以充分发挥想象，在自己的软件业务逻辑中加入 AI 来提升应用能力与效率！
- 智能客服（AI 问答）：
- 保险、律所、工具、电商的 AI 问答小助手/智能客服，给 AI 上传某个行业场景内的专业知识，AI 基于用户的问题来进行回答。例如将 Zion 的帮助文档提供给到 AI ，用户向 AI 提问 Zion 的相关操作问题时，AI 可以基于 Zion 帮助文档来进行回答
- 市场营销（AI 创作）：
- 销售/咨询话术生成，提供用户的基本信息，销售/咨询资料，AI 基于这些资料来生成对应的销售话术
- 小红书文案、抖音视频脚本、影视剧本编写
功能入口
点击 Zion 编辑器左上角的【Z AI】按钮，即可进入创建 AI 请求的界面，点击【开始创建】按钮即可添加一个新的 AI 请求
配置说明
左侧为 AI 请求配置界面，右侧为 AI 调试界面
定义请求名称
AI 请求名称：默认为 Ai-Config-1，可根据业务需求定义 AI 请求名称，方便在调用时快速识别合适的请求
基础配置
大模型： 选择完成 AI 业务的大模型版本，大模型版本的选择可能对返回结果有影响
- 更高级的大模型在调用时也会消耗更多的 App Token
- 目前仅 GPT 4.0 turbo 支持图片处理
AI 性格： 即你期待大模型生成的结果是更理性还是更感性，数值在0-1之间，数值越小，大模型生成的结果越理性准确，数值越大，生成的结果则更富有创造力
最大轮数： 即在调试时，可与 AI 对话的最大次数。向 AI 发送指令，AI 在不调用任何工具的前提下给到回复，则算 1 轮；若向 AI 发送指令，AI 调用个了 1 个 API 工具，然后根据工具内容给到回复，则算 2 轮
每轮字数限制： 即每一轮发送给 AI 以及 AI 返回的最大字数
⚠️ 注意：当开启多轮时，每一轮新的对话都会带上之前对话的上下文，因此会导致每轮字数越来越多，从而消耗更多的 Token ，所以需要根据业务情况来设定每轮字数的限制，在避免超过大模型的处理限度的同时合理节约 Token 的使用
入参配置
入参配置： 配置调用 AI 请求时，需要传递给 AI 使用的单个或者多个参数，一般入参会直接提供给【预置提示】进行绑定使用，也可以作为【知识库-数据库】的过滤条件等
预置提示
预置提示： 即提示词，是发送给大模型的一段文本指令，告诉大模型要去完成什么任务或生成什么内容
提示词进阶指南
⚠️ 建议仔细阅读并了解 Prompt Engineering Guide（提示词工程指南），有助于您更系统的了解提示词的基本规范以及各类提示技术，让您在调试、使用 AI 应用时获得更加符合预期的结果
一份优质的提示词，虽然可能会消耗更多的 App Token 以及需要更多的等待时间，但生成的结果可能会更佳！
提示词来源
直接输入： 直接在任务角色、详情以及限制输入提示词内容，但这样配置会导致这个 AI 请求只会执行固定的任务 AI 入参引用： 点击输入框旁的【+】号，引用调用 AI 时传入的参数，这样的配置相比于直接输入就灵活很多，可以让调用 AI 请求的用户自己定义任务角色、详情以及限制，让请求能够完更加丰富的任务 直接输入 + AI 入参引用 ： 如果您的业务是帮助用户编写文案，任务角色或者任务限制是固定不变的，只需要用户提供任务详情即可，那么你可以在 AI 请求中直接输入固定的角色以及限制内容，任务详情利用 AI 入参获取即可 知识库： 从 Zion 数据库、第三方 API 或本地上传的文件中获取的数据
Z AI 提示词内容
Z AI 为了帮助用户提升提示词质量，将【预置提示】进行了结构化处理，新手用户根据下方结构填写或引用入参作为预置内容即可获得相对优质的结果
任务角色（Role）： 定义 AI 是一个什么角色，让 AI 更好的理解任务/问题，从而给出更好的结果，比如“帮助学生正确掌握英语语法的英语老师”、“保险公司的理赔专员”、”小红书母婴专栏作家“等 任务详情（**Goals**）： 定义 AI 要去执行的任务是什么，比如是要让 AI 去回答问题、编写文案还是做信息提取，以及是否要结合其它一些上下文或者知识库来作为执行任务时候的参考 任务限制（Constraint）： 定义 AI 执行任务时候的限制条件，比如要做什么、不要做什么、多少字数、要包括什么关键词、需要什么风格、需要精确到几位数，生成富文本等等
举个例子:
- 扩展知识领域：外部知识库可以为 AI 大模型提供额外的领域专业知识，使其能够回答更广泛的问题。这有助于提高模型的通用性，使其在各种领域都表现出色。
- 提供实时信息： 外部知识库可以包含最新的数据和信息，帮助 AI 模型了解当前的事件和趋势。这对于涉及时事新闻、股票市场、天气预报等信息的任务特别有用。
- 更多作用：改善答案的准确性、提高语境理解、处理稀有领域问题、语言翻译和跨文化理解、弥补知识不足
举个例子： 例1： 我想做一个 Zion AI 开发小助手，用户可以向这个小助手提问关于 Zion 的开发使用相关问题，为了让 AI 能够准确回答用户问题，就需要给 AI 提供 Zion 的官方文档 例2：我想做一个公司内部财务报销小助手，公司内部同事在报销时可以预先提问 AI 助手，为了让 AI 能够精准回答同事的问题，就需要给 AI 提供公司财务报销相关的文档内容
知识库来源
Z AI 支持多种知识库数据源，包括 Zion 数据库、第三方 API 以及本地上传
数据：即 Zion 自带的数据库的数据， 选择已经存储在 Zion 中的单个或者多个数据表、单个或者多个字段、关联表/关联字段，选择的数据表还能够预先做数据限额、过滤条件、排序以及去重的操作
⚠️ 注意:读取的数据会直接给到 AI ，从而消耗 Token ，所以在配置时建议控制读取的数据条数以及内容量，根据业务情况来设定数据限额，在避免超过大模型的处理限度的同时合理节约 Token 的使用
| img | img |
|---|---|
 |
 |
- 若想利用 RAG 给大模型提供私有知识，了解【数据向量化存储与排序】
第三方 API： 即调用在 Zion 中配置好的第三方 API 获取到的数据，选择需要调用的 API 请求，设置对应的入参内容以及出参描述。了解【API 配置说明】
本地上传： 选择本地文件上传到该 AI 配置，上传后的内容会自动进行分段、向量化处理，配置入参之后，会自动检索最相关的内容给到大模型作为上下文
- 目前仅支持 Word、PDF、txt、md格式的文件
- 文件总大小不超过50MB
工具调用
为什么要调用工具
在人工智能代理（AI Agent）中，大语言模型类似于代理的大脑，主要负责逻辑思维和任务规划。然而，这些模型无法直接与外界互动；它们需要通过调用各种工具，如 API 请求或其它中介软件，来实现与外界的交互，类似于人类的手脚，使得 AI 能够执行具体的任务。这些工具使 AI 能够执行数据检索、图像生成、或与环境的其它形式的交互。工具类型
在 ZAI 中，可以让 AI 调用已经在 Zion 中配置好的行为流、API 以及其它的 AI 请求，也可以打开「获取更多信息」，让 AI 自行判断如果上下文不足以支撑业务时，反问用户获取更多上下文
调用行为流
前置准备： 了解 【行为流配置基础】，完成行为流配置，保存并发布该行为流 选择配置好的行为流之后，点击行为流右侧添加描述按钮为行为流本身以及行为流中的输入（入参）、输出（出参）添加描述，让 AI 知道该行为流的作用以及要传入的参数跟要输出的数据是什么
调用 API
前置准备： 了解【API 配置说明】，完成 API 配置与调试，保存配置并发布该 API
选择配置好的 API 之后，点击 API 右侧添加描述按钮为该 API 添加描述，让 AI 知道要传递什么入参以及API 返回的出参是什么
调用 AI
前置准备： 已经在 Zion 中完成了其他 AI 请求的配置并发布该 AI 请求 同上方的行为流以及 API ，选择了配置好的其他 AI 之后，为该 AI 添加描述，让当前 AI 知道这个 AI 工具的作用是什么以及入参、出参数据是什么
输出配置
默认： 当你的任务限制中没有任何输出格式的限制时，AI 会按照默认的方式输出结果，比如任务是计算一组数据，那么输出结果可能就是一个数字，如果任务是写一篇文章，那么输出结果可能就是一大段文本 自定义： 如下图所示，以「JSON」对象的形式输出结果，支持自定义 JSON 对象的结构以及其中的字段名称，并且为其添加描述，告诉 AI 该字段的意义
流式输出：AI 模型在生成结果时逐步显示生成内容。流式输出可以减少延迟从而提升用户体验。
⚠️ 注意：由于输出特性，流式输出时只能作为页面展示用，无法作为项目数据流转的一部分；在调用 AI 的成功时，输出结果才可作为正常文本使用进一步使用，如保存到数据库等
调试与预览
当完成了 AI 的配置之后，可以在界面右侧输入入参，调试、预览该 AI 请求
下方为 AI 运行的全过程，AI 运行成功时，你可以查看给 AI 提供的入参、工具调用情况以及返回结果是否符合预期，如果定义了多轮对话轮次，在此处可以输入新的入参继续对话
