> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Copilot Search

> 配置一个使用 Microsoft Copilot 搜索网络并存储结果供后续步骤使用的工作流步骤

# Copilot Search

当你希望工作流步骤从 Fetch Hive 使用 Microsoft Copilot 搜索网络并将结果传入后续工作流步骤时,请使用 **Copilot Search**。

## 配置

| 选项                                             | 是否必填 | 说明                                                       |
| ---------------------------------------------- | ---- | -------------------------------------------------------- |
| Name                                           | 否    | 步骤在工作流画布中的标签。                                            |
| Search Query                                   | 是    | **Search Query** 中的查询。此字段通过 **Insert Variable** 支持工作流变量。 |
| Location                                       | 否    | **Location** 中的位置值。你可以从列表中选择或启用 **Custom Value**。        |
| Location Custom Value                          | 否    | 控制 **Location** 使用内置列表还是自定义值。                            |
| When the step fails                            | 否    | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。     |
| 从 **Search steps...** 的 **Microsoft** 分组添加此步骤。 |      |                                                          |

**Search Query** 字段支持 **Insert Variable**。**Location** 字段可以使用内置列表,或当你想手动输入值或插入工作流变量时切换到 **Custom Value**。

## 输出

点击步骤标题中的 **Run** 来测试步骤。运行完成后,Fetch Hive 会在 **Output** 中显示搜索结果输出。

在后续步骤中使用变量选择器插入该次运行可用的确切输出路径。基础引用为:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

如果你想要完整的结果集,直接引用基础输出:

```text theme={null}
{{step_2.output}}
```

在测试运行后使用变量选择器检查返回的 Copilot 结果中可用的任何嵌套字段。

## 示例

从 **Search steps...** 的 **Microsoft** 分组中添加 **Copilot Search**。

将 **Name** 设置为类似 `Find Microsoft ecosystem coverage` 的内容。

在 **Search Query** 中输入你的查询。如果查询应重用早前工作流步骤的值,点击 **Insert Variable** 并添加该引用。

从列表中选择 **Location**,或者如果你想输入位置或插入变量,则切换到 **Custom Value**。

选择 **When the step fails** 时应执行的行为。

点击 **Run** 并在 **Output** 中查看返回的结果,然后再在后续步骤中使用。

{/* Add screenshot: Copilot Search settings sheet with query and location */}

## 备注

* 此步骤显示在步骤选择器的 **Microsoft** 之下,而不是 **Research** 之下。
* 编辑器不会为此步骤显示语言、结果数量或备用控件。
* 如果你需要后续引用的确切返回字段,运行该步骤一次并检查变量选择器。

另见:[创建和编辑](../../creating-and-editing)、[测试与迭代](../../testing-and-iteration) 和 [错误处理](../../error-handling)