摘要
本指南将介绍如何在 Astra 中配置 Google Sheets — 搜索和查找行 操作。此操作允许您的代理读取和检索选定的 Google Sheets 工作表（标签页）中的行，并将结果作为结构化列表返回。
为确保操作正常工作，您的电子表格必须包含 顶部的一行非空标题行。这些标题定义了 Astra 读取的数据的结构。
在配置操作之前，请确保您的 Google 账号已连接到 Astra。
说明
请按照以下步骤配置 Google Sheets — 搜索和查找行 操作：
第 1 步：打开操作模板
登录您的 Astra 账号。
前往 操作库。
选择 Google Sheets — 搜索和查找行。
打开 配置 页面。
您将在该页面配置多个部分。
第 2 步：配置操作意图
在 操作意图 部分：
输入 操作名称。
编写一个 意图，解释代理应何时在电子表格中查找行。
为什么这很重要
意图有助于代理理解 何时应使用此操作。
清晰的说明可以提高触发操作的准确性。
例如，当用户询问客户详细信息或需要检索已存储的信息时，代理可能会搜索工作表。
第 3 步：选择 Google 账号
在 Google 账号 部分：
选择拥有电子表格访问权限的 已连接的 Google 账号。
工作原理
Astra 使用选定的账号通过安全的 OAuth 身份验证来访问 Google Sheets。
电子表格必须可以从该账号访问。
第 4 步：选择电子表格和工作表
在 电子表格和工作表 部分：
选择 云端硬盘位置。
选择 电子表格。
选择包含数据的 工作表（标签页）。
重要提示：
只能使用位于 我的云端硬盘 或 共享云端硬盘 中的电子表格。
Astra 只会读取选定的工作表中的数据。
第 5 步：配置行过滤
您可以使用 仅读取相关行 的切换开关来控制 Astra 如何读取行。
选项 1：开关关闭（读取整个工作表）
当开关 关闭 时：
Astra 会读取 整个工作表。
所有行都会返回给代理。
最适合：
包含 小型数据集（约 1,000 行或更少）的工作表。
选项 2：开关打开（仅读取相关行）
当开关 打开 时：
Astra 会尝试 过滤并仅返回相关行。
代理会搜索数据，而不是读取整个工作表。
关于匹配的重要注意事项：
对于 ASCII 文本，匹配是 近似的（模糊）。
搜索通常是：
不区分大小写
对空格或标点符号不敏感
对于 非拉丁文本，匹配更字面化，可能需要更精确的匹配。
最适合：
包含 大型数据集 的工作表，其中读取整个工作表效率低下。
操作运行时会发生什么
触发操作时：
Astra 会读取选定的 Google Sheets 工作表。
它会根据配置的设置检索行。
这些行将作为 结构化数据列表 返回给代理。
这使得您的工作流能够动态检索存储在 Google Sheets 中的信息，例如客户记录、产品数据或内部跟踪信息。