Agent平台组件开发规约 操作手册
1. 应用入口
可点击注册账号使用平台。
2. 名词解释
2.1. 什么是智能体/助手
在Agent 平台中，助手通常指的是以大模型为核心的智能体，它通过与用户的对话形式来完成各种任务。通过角色定义prompt，我们可以为助手指定特定的角色和任务，使其在特定的应用场景中表现得更像一个专业的助手。
角色定义prompt 是一种与大模型交互的关键技巧，它可以帮助大模型更好地理解用户的意图和需求。通过为助手设定明确的角色和目标，我们可以指导助手按照预期的方式行动。例如，我们可以将助手定义为一个新闻助手，其目标是搜索并总结新闻。在这个角色中，助手需要具备网络搜索、网页解读和内容甄别等技能。我们还需要明确提出要求，比如用中文总结新闻，并给出5 篇新闻的标题和摘要。此外，我们还可以定义工作流，指导助手先搜索新闻，然后甄别最近的新闻，最后总结内容输出。这样的角色定义prompt 有助于实现特定的应用助手，使其在执行任务时更加专业和高效。
同时，助手支持通过集成API、插件和工作流编排，能够扩展其能力，适应各种业务场景，实现个性化服务和高级自动化任务。
2.2. 什么是技能
技能是通过可视化的节点工具、插件能力配置而成的执行流程的应用。它允许用户通过拖拽组件的方式来构建和设计执行过程，其作用在于通过可视化
的方式简化任务管理，提升工作效率，确保各个环节的协调与执行，从而使得智能体能够更高效地完成用户的需求和任务。通过编排，用户可以灵活地调整工作流程，适应不同的业务场景和需求变化。
2.3. 什么是插件
插件是一种模块化的软件组件，它能够为平台提供额外的功能或增强现有功能。插件的作用是允许用户根据自己的需求定制和扩展平台的能力，而无需修改平台的核心代码。通过安装不同的插件，用户可以轻松地添加新的功能，如自动化任务、数据集成、用户界面扩展等，从而使平台更加灵活和强大。
2.4. 什么是知识库
知识库是存储和管理信息的集合，用于增强基于大模型的理解和响应能力。它结合了 RAG（Retrieval-Augmented Generation）技术，通过检索相关的结构化数据、文档和FAQ 等信息资源，帮助大模型应用根据用户需求生成最终的答案和服务。
目前，扳手AI 平台知识库知识类型包括以下几个（逐步开放使用）
文本：支持上传 txt、docx、pdf、pptx 格式
表格：支持上传 xlxs 格式
图片：支持上传 png、jpg、jpeg、bmp 格式
音频：支持上传mp3、m4a 等格式
应用：支持添加应用类型的知识库
网址：支持添加网址类型的知识库
问答：支持添加问答类型的知识库
2.5. 公开配置的作用
公开配置是指创建者可以将其创建并发布的大模型应用（包括智能体和技能）及其配置“公开”给其他用户。这意味着其他用户可以查看和使用该应用及其配置信息（如Prompt、插件等），并在此基础上进行创作。
3. 功能操作
3.1. 如何创建智能体
-
登陆扳手 AI 平台。
-
在扳手AI 平台顶部菜单栏点击【我的AI 应用】-【新增智能体】。
扳手AI 平台_操作手册
- 输入智能体名称和类型，上传图标。
4. 点击【确定】。
智能体创建后会直接进入编排页面。
助手优化弹窗页面，系统自动生成画像提示词以及相关配置（开场白、引导问题、插件和技能），用户可以选择【全部使用】或【取消】。
左侧【助手配置】栏可以设置智能体的角色、基础配置、引导配置、知
识库配置以及能力配置；
右侧调试预览页面中，实时调试智能体。
3.1.1. 什么是角色定义
角色定义是对智能体的一个提示词配置信息，它通过描述与大模型的交互方式来指导生成特定类型的内容或执行特定任务。目前，就一般而言，提示越清晰，就越符合设定的预期。角色定义一般包括角色、技能、限制等。
在【角色定义】栏，你可以单击【助手优化】使用 AI 帮你优化智能体的画像，以便大模型更好地理解你的意图。
3.1.2. 开场引导的作用
通过给智能体设置【开场白】和【引导问题】，帮助用户更好地了解智能体的能力。
开场白
-
建立第一印象：开场白是用户与Agent 交互的第一步，它帮助建立用户对Agent 的第一印象，设置友好、专业的基调。
-
介绍 Agent 的功能：通过开场白，可以简洁地介绍 Agent 的主要功能和它能为用户提供的服务。
-
设定期望：开场白可以设定用户对Agent 的期望，让用户知道他们可以期待什么样的帮助和支持。
引导问题
-
明确用户需求：引导问题帮助Agent 快速了解用户的具体需求，从而提供更精准的帮助。
-
引导对话方向：通过提出问题，Agent 可以引导对话朝着解决问题的方向发展，避免无目的地闲聊。
-
激活用户参与：引导问题鼓励用户参与到对话中来，增加互动性，使对话更加有效。
3.1.3. 添加知识库的作用
知识库存储和组织了大量的结构化与非结构化信息，包括文本、表格、图片、音频等格式文件，为智能代理提供决策支持。通过检索和匹配用户查询或任务需求，知识库能够快速准确地提取相关信息，辅助智能代理生成恰当的响应或解决方案，从而提升交互效率和服务质量，确保使用者获得所需的信息或帮助。
3.1.4. 能力配置，添加插件的作用
插件在Agent 智能体中的作用是扩展其功能和能力，使其能够执行更多种类的任务。例如，通过添加代码执行器插件，Agent 可以在需要时执行代码，从而解决大模型本身无法处理的编程问题。此外，插件如论文搜索、AI 绘图、语音识别等，可以赋予Agent 特定的专业技能，增强其在特定领域的表现。这些插件相当于为Agent 提供了额外的“工具箱”，使其能够更灵活地应对各种复杂任务和环境挑战。
3.1.5. 能力配置，添加技能的作用
智能体工作流技能的添加能够显著提升AI 在执行复杂任务时的性能和效率。通过引入反思、工具使用、规划和多智能体协作等模块，AI 能够在执行任务过程中进行自我调整和优化，从而生成更准确和高质量的结果。这种双线式的反馈和优化机制减少了对单一模型性能的依赖，使得即使是较旧的模型也能通过智能体工作流达到甚至超越新模型的表现。此外，智能体工作流的设计还促进了多智能体之间的协同合作，提高了任务处理的稳定性和可扩展性。
3.2. 如何创建技能
1、登陆扳手AI 平台。
2、在扳手AI 平台顶部菜单栏点击【我的AI 应用】-【技能】-【新增技能】。
3、填写配置信息后选择【下一步，高级配置】，进入工作流页面
3.2.1. 技能编排操作
1、在工作流的编辑页面，从左侧选择需要的节点插件拖入到中间编排区域，连
接各节点并配置输入输出参数。
2、配置完成，点击右上角【保存】
3、系统提供配置问题清单功能，点击右上角带问题数量的 图标，点击【定位问题】可在编排区域查看配置问题的字段，完善后保存即可。
3.3. 创建完成后怎么发布
智能体或者技能创建完成后，默认为草稿状态，我们需要将它发布才能够
进行使用。发布分为两类：1、私有发布，2、公开发布。具体如下：
1、私有发布
点击“发布选项”按钮，发布范围选择“私有发布”，即可在体验中心页面下“我的应用”处使用智能体。
2、公开发布
点击“发布选项”按钮，发布范围选择“公开发布”，并填写配置信息，选择是否公开配置，以及公开的角色范围（公开给哪些角色的用户使用，除特
殊用户外，大部分用户为普通用户角色）。提交后为“发布审核”状态，需等待后台管理员对发布的应用进行审核，通过后在体验中心上线供对应角色用户使用。
如果审核被拒绝，状态变为“拒绝发布”状态，点击“？”可查看拒绝理由，并可以重新发起申请。
公开配置解释详见章节2.5
3.4. 体验中心
3.4.1. 对话
点击对应的应用，即可开启对话。
3.4.2. 收藏使用
点击应用卡片中心的收藏按钮，即可将应用加入个人收藏。
再点击一次则取消收藏。
3.4.3. 新增会话
对话过程中，需要中止之前的对话，开启新一轮对话，可点击对话页面左
侧“新增会话”按钮，开启新一轮对话。
3.4.4. 会话记录
点击左侧“会话记录”按钮，可查看历史会话记录
3.4.5. 复制智能体
在体验中心应用中，带有“公开配置”标签的助手应用，代表着该应用的配置项已公开，开放给用户参考使用。
扳手AI 平台_操作手册
进入应用对话窗口后，点击左侧“复制智能体”按钮，即可复制该应用的各配置项。
4. 技能节点介绍
4.1. 网页内容
网页内容工具，能够精准捕获并提取指定网页上的数据并进行输出。
配置示例：
4.2. 数据库连接
提供数据库连接工具，支持与用户指定的数据库建立连接，并执行查询操作，进而提取和展示数据库中的相关数据信息并输出
4.3. HTTP 请求
提供HTTP 请求工具，允许用户通过定义API 接口、设置请求头
（HEADERS）、参数（PARAMS）和请求体（body），来实现与外部服务或数据源的交互，从而获取或发送信息。
配置示例：
4.4. 大模型
技能编排功能支持用户选择并配置AI 大模型，包括定义聊天模式、设置提示词和引导问题等，以定制化对话流程和提升交互体验。
配置示例：
扳手AI 平台_操作手册
4.5. 条件分支
技能编排中的条件分支功能，通过用户根据预设的条件逻辑，智能地选择并执行不同的操作路径，从而实现动态和灵活的流程控制。
配置示例：
4.6. 参数提取器
在技能编排中，参数提取器工具能够精准地从流程中抽取关键参数，使得这些参数可以被进一步处理或用于触发其他操作，增强了整个编排过程的灵活性和自动化程度。
配置示例：
4.7. 知识库
知识库节点能够选取特定的知识库，并根据输入内容检索知识库并输出相关信息。当用户提出问题或需要获取某方面的信息时，工作流可以通过知识库节点快速地从预设的知识库中查找并返回相应的答案或数据。
配置示例：
4.8. 意图识别
技能编排中的问题分类功能，通过分析用户的历史交互记录和当前提问内容，智能识别并分类用户的问题类型。智能地选择并执行不同的操作路径，从
而实现动态和灵活的流程控制。
示例：
4.9. 自定义组件
技能编排中的自定义组件功能，支持用户编写特定的代码逻辑，实现个性化的功能扩展，并将结果输出或返回，以满足特定的业务需求或创新应用场景。
配置示例：
4.10. 小程序
小程序节点是在工作流编排中编写和执行前端页面代码。允许开发者在无需离开对话界面的情况下，快速构建和部署交互式网页应用。通过在智能体工作流中嵌入小程序节点，能够扩展AI 的能力边界，为用户提供更加丰富和个性化的互动体验。
配置示例：
4.11. 向量库
向量库节点在工作流中通过配置与特定知识数据源的连接信息，能够执行基于语义的查询，检索出数据源中与查询语义相似的数据片段。并通过计算向量间的相似度来定位最相关的信息，从而为Agent 技能提供知识支持和决策辅助。
配置示例：
