摘要
本指南说明如何在 Astra 中配置 Google Sheets — 更新行 操作。此操作允许您的代理程序更新选定的 Google Sheets 工作表（标签页）中现有的一行。
为确保操作正常运行，工作表顶部必须包含 一行非空的标题行。这些标题定义了更新值时使用的列结构。
在大多数工作流程中，代理程序必须首先使用 Google Sheets — 搜索和查找行 操作 定位要更新的行。一旦确定了正确的行， 更新行 操作就可以修改该行中的值。
在配置此操作之前，请确保您的 Google 帐户已连接到 Astra。
说明
请按照以下步骤配置 Google Sheets — 更新行 操作：
第 1 步：打开操作模板
登录到您的 Astra 帐户。
转到 操作库。
选择 Google Sheets — 更新行。
打开 配置 页面。
您将在此页面上配置几个部分。
第 2 步：配置操作意图
在 操作意图 部分：
输入 操作名称。
撰写一个 意图，解释代理程序何时应更新电子表格中的行。
为什么这很重要
意图可以帮助代理程序了解 何时应使用此操作。
清晰的说明可提高代理程序触发更新的准确性。
示例用例包括更新客户状态、修改订单详细信息或更改潜在客户信息。
第 3 步：选择 Google 帐户
在 Google 帐户 部分：
选择 已连接的 Google 帐户，该帐户具有编辑电子表格的权限。
工作原理
Astra 使用选定的帐户通过安全的 OAuth 身份验证访问 Google Sheets。
帐户必须具有对电子表格的 编辑访问权限。
第 4 步：选择电子表格和工作表
在 电子表格和工作表 部分：
选择 云端硬盘位置。
选择 电子表格。
选择应更新行的 工作表（标签页）。
重要提示：
此操作只能使用位于 我的云端硬盘 或 共享云端硬盘 中的电子表格。
更新将仅应用于 选定的工作表。
附加功能：离线同步
Astra 还支持 离线同步，这允许此操作在 对话结束后 运行，而不是在实时互动期间运行。
离线同步的工作原理
如果在 操作意图 页面启用了 离线同步：
在 对话结束后 且 ASTRA 捕获了潜在客户后，操作将运行 一次。
更新 不会 在实时聊天期间发生。
对话结束条件
文本代理程序： 自上次消息以来 10 分钟 已过，则认为对话结束。
语音代理程序： 通话结束后，对话结束。
启用离线同步时：
代理程序工作流程中 不需要 搜索和查找行 操作。
Astra 会在对话结束后自动处理更新。
操作运行时会发生什么
触发操作时：
Astra 会识别所选工作表中的正确行。
代理程序根据工作流程上下文生成更新的值。
该行中的指定字段将被更新。
这使您的工作流程能够自动维护 Google Sheets 中的准确数据，例如更新客户记录、潜在客户信息或运营跟踪数据。