第2章 AI Agent 构建入门
第2章:构建Agent入门
在 Budibase 中,Agent 让 AI 能够与您的 Workspace 中的数据、工具和自动化流程进行交互。
在这篇指南中,我们将构建一个简单的 AI 服务台 Agent,它具备以下功能: * 回答有关工单的问题 * 分类并总结新工单 * 更新工单状态
在此过程中,您将学习如何: * 配置 Agent 的指令 * 将 Workspace 数据连接为工具 * 定义结构化输出 * 从 Agent 操作触发自动化流程 * 安全地进行测试和迭代
开始之前 请确保您具备以下条件: * 已在 Agent 配置中设置了模型提供商 * Workspace 中有一个工单(Tickets)表 * 拥有创建 Agent 和自动化的权限
什么是 Agent? Agent 即: * 配置了以下内容的 LLM: * 指令 * 工具 * 记忆 * 结构化输出
Agent 可以: * 读取数据 * 写入数据 * 触发自动化流程
搭建数据层 在 Budibase 中,只要显式授予访问权限,Agent 就可以与 Workspace 中的任何表、API 调用或自动化流程交互。 在创建 Agent 之前,请定义它将处理的数据以及允许其执行的操作。 有关 Budibase 中数据工作方式的更多细节,请参阅《数据入门》。
我们的工单表 在本指南中,我们将使用一个名为 Tickets 的 Budibase 数据库表。 该表包含以下列:
Name Field Type Title Text Description Long form text Status Single select Priority Single select Time Created Date Resolution Notes Long form text Created By Single user Category Single select
创建我们的 Agent 要创建第一个 Agent,请先确保已选择提供商并配置了模型。请参阅《Agent 配置》。
1. 点击屏幕左侧的 Agents 链接 2. 点击屏幕右上角的 + New Agent 按钮 3. 提供名称。我们将使用 Service Desk Agent 4. 这将重定向到 Agent 配置界面。
配置指令 Agent 通过操作(Operations)来执行任务。一个 Agent 可以拥有一个或多个操作,每个操作拥有自己的一套指令和工具。为了开始,我们需要创建第一个操作:
1. 在 Agent 配置界面的操作区域,点击 Add operation。 2. 为操作命名(例如,“Support Triage”),点击 Create。 3. 您将跳转到操作详情页面。
默认情况下,Budibase 提供结构化的指令模板,帮助您清晰定义操作。有关此模板的更多信息可在此处找到。 请在本指南中使用以下指令: 操作角色 你是一个负责管理支持工单的服务台 AI Agent。
输入 你接收工单数据,包括标题、描述、状态和优先级。
动作 - 对新工单进行分类。 - 建议优先级(低、中、高) - 回答有关工单状态的问题 - 在读取或更新工单时使用可用的工具
输出 清晰简洁地回复。 在分类或确定优先级时,返回结构化 JSON: { "category": "string", "priority": "Low | Medium | High" }
规则 - 除非明确指示,否则不要修改工单 - 保持简洁和专业 - 尽可能使用英式英语
配置并添加上述指令后,运行测试并确认一切正常。
添加工具 工具允许 Agent 获取和修改 Workspace 中的实时数据。您必须显式启用操作所需的每个工具。 在本例中,我们将授予 Agent 访问 Tickets 表中三个工具的权限:
* Budibase: Tickets.List Rows - 检索多个工单 * Budibase: Tickets.Get Row - 检索特定工单 * Budibase: Tickets.Update Row - 更新现有工单的字段
要添加这些工具:
1. 在指令编辑器中输入 {{ 以打开自动完成菜单。 2. 选择 Add tool。 3. 搜索并选择所需的工具(例如 Tickets.List Rows)。 4. 配置执行主体(Execution principal,本指南使用 Requester),点击 Add tool。
组合起来,这些工具使 Agent 能够: * 在回答问题时查找工单 * 检索特定工单详情 * 在需要时更新工单状态、优先级或解决备注
作为最佳实践,仅启用所需的最小工具集。限制工具访问有助于保持行为的可预测性和安全性。
添加知识 除了工具,Agent 还可以使用知识源(Knowledge Sources)基于外部文档或网站回答问题。这通常被称为 RAG(检索增强生成)。 📘 注意 知识功能需要在您的 Budibase 环境中配置 GEMINI_API_KEY。如果缺少此密钥,构建器中的知识操作将被禁用。
连接 SharePoint 知识 您可以快速添加 SharePoint 站点作为知识源,而无需手动配置 REST 连接器:
1. 在操作详情页面,前往右侧设置栏中的知识标签。 2. 点击 Add source 并选择 SharePoint。 3. 如果没有现有连接,请输入您的目录(租户)ID、应用程序(客户端)ID 和客户端密钥。 4. Budibase 将自动创建连接,并允许您选择要同步的 SharePoint 站点。
对于更复杂的配置,您可以使用连接弹窗中的高级设置选项,直接跳转到 SharePoint REST 连接器设置。
更新我们的指令 启用这些工具和知识源后,我们需要引导 Agent 何时使用它们。 请使用以下更新的指令提示: 操作角色 你是一个负责管理支持工单的服务台 AI Agent。
输入 你接收工单数据,包括标题、描述、状态和优先级。
可用工具 {{ budibase.Tickets.list_rows }} {{ budibase.Tickets.get_row }} {{ budibase.Tickets.update_row }}
动作 - 对新工单进行分类。 - 建议优先级(低、中、高) - 回答有关工单状态的问题 - 在检索或更新工单数据时使用适当的工具
输出 清晰简洁地回复。 在分类或确定优先级时,返回结构化 JSON: { "category": "string", "priority": "Low | Medium | High" }
规则 - 访问工单数据时始终使用提供的工具 - 不要编造工单信息 - 除非明确指示,否则不要修改工单 - 保持简洁和专业 - 使用英式英语
可选地,再次使用一些数据进行测试,查看其处理流程的方式。
管理多个操作 随着 Agent 变得更加复杂,您可以定义多个操作,每个操作拥有自己的专用详情页面,包含各自的指令、工具和知识。 当 Agent 拥有多个实时操作时,Budibase 使用内部路由器来检测用户请求的意图。它会: * 如果请求明确匹配某个操作的重点,则选择该特定操作。 * 如果用户提出广泛问题(如“你能帮我什么?”)或请求 Agent 任务概述,则总结其能力。 * 如果请求与任何已定义的能力无关,则不经过任何操作继续处理。
您无需手动配置此路由;它是根据您为每个操作提供的名称和指令自动处理的。
测试 Agent 既然您的 Agent 已具备指令和工具,您可以测试其行为是否安全且可预测。 从一些代表性提示开始:
* 当前有哪些未关闭且高优先级的工单? * 总结工单“财务部门的打印机访问故障”并建议分类+优先级。 * 将工单“远程用户 VPN 问题”更新为处理中,并添加简短的解决备注。
对于每次测试,请检查: * 工具使用:Agent 应使用 list/get 工具检索实时数据,仅在明确要求时才使用 update。 * 输出格式:分类响应应遵循我们定义的 JSON 模式。 * 数据准确性:返回的值应与 Tickets 表中的行数据匹配。 * 安全规则:除非提示要求,Agent 应拒绝更新。
如果行为不一致,请收紧您的指令。例如: * 明确何时允许更新。 * 添加有效和无效请求的示例。
小的提示编辑和频繁测试是获得可靠行为的最快途径。
自动触发 Agent 手动测试看起来不错后,您可以在创建新工单时自动运行此工作流。 在本例中,我们将使用自动化流程在工单到达时对其分类和确定优先级:
1. 创建具有 Tickets 表“行已创建”触发的自动化流程。 2. 添加一个 LLM 提示动作来处理标题和描述,并返回: * 分类 * 优先级 3. 添加一个更新行动作,将生成的分类和优先级写回创建的工单。 4. 添加条件步骤: * 如果优先级为高,触发您的通知路径(例如,发送外部通知)。
使用多个示例工单进行测试,以确认完整流程。
这为您提供了一种实际的责任划分: * 消息渠道处理交互式支持任务、问答和指导式更新 * 自动化流程在后台处理可重复、事件驱动的初步筛选
结合起来,这些提供了一个可靠的服务台工作流,同时具备人工介入和全自动路径。
后续步骤 一旦此基础正常运行,请使用这些指南来提高质量和安全性: * Agent 指令指南 * Agent 工具和权限 * Agent 嵌入模型 * Agent 向量数据库 * Agent 测试指南 * Agent 故障排除
更新于大约 2 个月前 此页面是否对您有帮助?