> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-reference.md).

# 注视注意力参考

注视注意力系统的完整属性、事件、方法和类参考，包括所有默认值和版本特定行为。

凝视注意力系统中所有属性、事件、方法和类的权威参考。以下 [Convai Player Component](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-player-component.md) 和 [Convai Object Component](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/blueprint-reference/convai-object-component.md) 页面仅概述各自组件内的凝视功能；如需了解完整的跨组件 API、默认值和特定版本行为，请参阅本页。

权威来源： `Source/Convai/Public/ConvaiPlayerComponent.h`, `Source/Convai/Public/ConvaiObjectComponent.h`, `Source/Convai/Public/Gaze/ConvaiGazeHighlightActor.h`, `Source/Convai/Public/Gaze/ConvaiGazeCursorWidget.h`以及 `Source/Convai/Public/ConvaiChatbotComponent.h`.

### `UConvaiPlayerComponent` — 凝视注意力属性

除非另有说明，所有属性都位于 Details 面板的 **Convai | Gaze Attention** 类别下。

#### 核心开关

| 属性                     | 类型     | 默认值     | 说明               |
| ---------------------- | ------ | ------- | ---------------- |
| `bEnableGazeAttention` | `bool` | `false` | 主开关。此项设为 `true`. |

#### 后，其他所有凝视属性才会启用。

| 属性                       | 类型                | 默认值     | 说明                                                                                                    |
| ------------------------ | ----------------- | ------- | ----------------------------------------------------------------------------------------------------- |
| `GazeShouldRespond`      | `EC_RunLLMOption` | `Never` | 当凝视目标被提升为注意力目标时的行为。 `Always` — 聊天机器人立即生成回复。 `Auto` — 由 Convai 决定。 `Never` — 仅静默更新状态。                  |
| `GazeAttentionText`      | `FString`         | `""`    | 随注意力提升一同发送的叙事事件文本（例如 `"Player is looking at the valve."`）。仅当 `GazeShouldRespond` 为 `Auto` 或 `Always`. |
| `GazeAttentionDelay`     | `float` （秒）       | `1.0`   | 物体被高亮显示后，持续注视多长时间才会将其提升为“正在关注”。                                                                       |
| `GazeAttentionLossDelay` | `float` （秒）       | `5.0`   | 移开视线多长时间后，才会释放当前注意力槽位。                                                                                |

#### 追踪设置

| 属性                   | 类型                                    | 默认值              | 说明                                                                                                                             |
| -------------------- | ------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `GazeMaxDistance`    | `float` （厘米，AdvancedDisplay）          | `5000.0`         | 从玩家摄像机或 VR 头显到目标的最大射线追踪距离。                                                                                                     |
| `GazeAngleTolerance` | `float` （度）                           | `5.0`            | 点积回退锥的半角。如果严格射线追踪未命中有效的注视目标，且未被非 Convai 几何体阻挡，系统会遍历子系统池中的所有 `UConvaiObjectComponent` 实例，并在此锥形范围内选出与视线方向对齐程度最高的实例。设为 `0` 可禁用回退。 |
| `GazeTraceChannel`   | `ECollisionChannel` （AdvancedDisplay） | `ECC_Visibility` | 注视线性射线追踪使用的碰撞通道。                                                                                                               |

#### 高亮属性（类别：Convai | Gaze Attention | Highlight）

| 属性                               | 类型                                       | 默认值                          | 说明                                                                                                    |
| -------------------------------- | ---------------------------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------- |
| `GazeHighlightActorClass`        | `TSubclassOf<AConvaiGazeHighlightActor>` | 插件默认值                        | 在被注视对象上生成的高亮 Actor 类。指定一个子类即可自定义视觉效果。                                                                 |
| `GazeHighlightColor`             | `FLinearColor`                           | `(1.0, 0.9, 0.2, 1.0)` （浅黄色） | 传递给高亮 Actor 的 `HighlightColor` 属性，然后调用 `SetTarget` 。                                                  |
| `GazeOverlayMaterial`            | `TSoftObjectPtr<UMaterialInterface>`     | 未设置                          | 叠加材质。未设置时，插件会使用 `/ConvAI/Highlights/M_ConvaiGazeOverlay` （菲涅耳边缘轮廓）。可替换为任何公开了 `EmissiveColor` 向量参数的材质。 |
| `GazeHighlightEmissiveIntensity` | `float` （AdvancedDisplay）                | `2.5`                        | 传递给高亮 Actor 的 `EmissiveIntensity` 标量参数。插件叠加材质会在内部将 `EmissiveColor` 乘以此值。                              |

#### 光标属性（类别：Convai | Gaze Attention | Cursor）

| 属性                      | 类型                                     | 默认值              | 说明                                       |
| ----------------------- | -------------------------------------- | ---------------- | ---------------------------------------- |
| `bShowGazeCursor`       | `bool`                                 | `true`           | 注视追踪处于活动状态时，显示屏幕中央的准星。                   |
| `bAlwaysShowGazeCursor` | `bool`                                 | `false`          | 即使注视点未落在 Convai 对象上，也让光标保持为“活动”视觉状态。     |
| `GazeCursorWidgetClass` | `TSubclassOf<UConvaiGazeCursorWidget>` | 插件默认值            | 光标使用的控件类。可使用 Blueprint 子类进行覆盖，以自定义准星外观。  |
| `GazeCursorActiveColor` | `FLinearColor`                         | 白色 `(1,1,1,1)`   | 注视 Convai 对象时的光标颜色。                      |
| `GazeCursorIdleColor`   | `FLinearColor` (AdvancedDisplay)       | `(1,1,1,0)` （透明） | 未注视任何对象时的光标颜色。默认 Alpha 值为 0，因此光标在空闲时不可见。 |
| `GazeCursorDotSize`     | `float` （Slate 单位，AdvancedDisplay）     | `6.0`            | 光标方块在未缩放 Slate 单位下的边长。                   |
| `GazeCursorFadeInTime`  | `float` （秒，AdvancedDisplay）            | `0.1`            | 从空闲状态淡入到激活状态的时长。 `0` 会立即切换。              |
| `GazeCursorFadeOutTime` | `float` （秒，AdvancedDisplay）            | `0.25`           | 从激活状态淡出到空闲状态的时长。 `0` 会立即切换。              |

### `UConvaiPlayerComponent` — 注视事件

所有事件都位于 **Convai | Gaze Attention | Events** 类别中，并使用委托类型 `FConvaiPlayerGazeEvent`.

**委托签名：** `(UConvaiPlayerComponent* PlayerComponent, UConvaiObjectComponent* ObjectComponent)`

| 事件                  | 触发时机                                                                                                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `OnGazeBegin`       | 玩家的视线进入 Convai 对象的瞬间触发。在达到任何注意力阈值之前触发。                                                                                                           |
| `OnGazeEnd`         | 玩家的视线离开 Convai 对象的瞬间触发，无论当前注意力状态如何。                                                                                                              |
| `OnAttentionGained` | 注视对象在经过 `GazeAttentionDelay` 秒后被提升为“受到关注”时触发。即使所有聊天机器人都拒绝此次更新，也会触发（例如，当 **Enable Actions** 关闭，或 `AttentionSource` 为 `Explicit (Blueprint/C++)`). |
| `OnAttentionLost`   | 释放“受到关注”槽位时触发——例如，丢失计时器到期、视线切换到另一个对象，或目标 Actor 被销毁。 `ObjectComponent` 可能为 `nullptr` （当注意力目标已被销毁时）。                                               |

{% hint style="warning" %}
`OnAttentionGained` 在玩家组件上表示已达到停留阈值，并不表示聊天机器人接受了此次更新。请检查 `AttentionSource` 在聊天机器人上，并确认 **启用操作** 开启时，角色将会作出响应。
{% endhint %}

### `AConvaiGazeHighlightActor`

由以下对象生成的轻量级 Actor： `UConvaiPlayerComponent` 用于在当前注视目标上提供视觉反馈。

**UE 版本行为：**

* UE 5.3 及更高版本：通过 `UMeshComponent` 的 `SetOverlayMaterial`.
* UE 5.0–5.2：改用 `DrawDebugBox` 绘制包围目标边界的方框。 `FallbackBoxThickness` 和 `FallbackBoxPadding` 仅控制这些版本中的线框外观。

**蓝图方法：**

| 方法                   | 签名                                                                 | 说明                                                                                 |
| -------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| `SetTarget`          | `(AActor* InTarget, USceneComponent* InTargetComponent = nullptr)` | 应用或清除高亮效果。传入 `nullptr` 即可清除。当 `InTargetComponent` 是 `UMeshComponent`时，叠加效果仅应用于该组件。 |
| `GetTarget`          | `() → AActor*`                                                     | 只读访问当前目标。                                                                          |
| `GetTargetComponent` | `() → USceneComponent*`                                            | 可选的子组件范围。 `nullptr` 表示高亮效果覆盖整个 Actor。                                              |

**属性：**

| 属性                     | 类型                                   | 默认值                    | 说明                                                                                                                                                              |
| ---------------------- | ------------------------------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `HighlightColor`       | `FLinearColor`                       | `(1.0, 0.9, 0.2, 1.0)` | 叠加材质的色调，对应其 `EmissiveColor` 参数。该值由 `UConvaiPlayerComponent::GazeHighlightColor`.                                                                                |
| `EmissiveIntensity`    | `float`                              | `2.5`                  | 写入叠加材质 `EmissiveIntensity` 参数的标量值。插件材质会在内部将 `EmissiveColor` 乘以此值。                                                                                               |
| `OverlayMaterial`      | `TSoftObjectPtr<UMaterialInterface>` | 未设置                    | 叠加材质。默认为 `/ConvAI/Highlights/M_ConvaiGazeOverlay`。仅当插件资源在打包版本中缺失时，才会回退到 `/Engine/EngineMaterials/EmissiveMeshMaterial` （注意：该回退材质没有参数，因此 `HighlightColor` 不会生效）。 |
| `FallbackBoxThickness` | `float` （AdvancedDisplay）            | `2.0`                  | UE 5.0–5.2 线框盒的线条粗细。                                                                                                                                            |
| `FallbackBoxPadding`   | `float` （AdvancedDisplay）            | `1.05`                 | UE 5.0–5.2 线框盒的范围倍数。                                                                                                                                            |

如需使用自定义高亮视觉效果，请在 Blueprint 中派生 `AConvaiGazeHighlightActor` 的子类，并将该子类赋给 `UConvaiPlayerComponent::GazeHighlightActorClass`.

### `UConvaiGazeCursorWidget`

屏幕中心的准星小部件，在凝视跟踪处于活动状态时由 `UConvaiPlayerComponent` 绘制。它是一个纯 C++ 小部件，使用 Unreal 的 `FCoreStyle::WhiteBrush` ——插件不包含纹理资源。

**蓝图方法：**

| 方法                   | 签名                                                   | 说明                                                    |
| -------------------- | ---------------------------------------------------- | ----------------------------------------------------- |
| `SetGazeActive`      | `(bool bInGazeActive)`                               | 当凝视进入或离开 Convai 对象时，由玩家组件调用。                          |
| `IsGazeActive`       | `() → bool`                                          | 返回当前凝视状态。在 `OnGazeStateChanged` 实现中很有用。               |
| `OnGazeStateChanged` | `(bool bInGazeActive)` (BlueprintImplementableEvent) | 在 Blueprint 子类中重写，以便在每次状态变化时执行自定义过渡效果——例如更换图像笔刷或播放动画。 |

**属性：**

| 属性            | 类型                          | 默认值              | 说明                                      |
| ------------- | --------------------------- | ---------------- | --------------------------------------- |
| `ActiveColor` | `FLinearColor`              | 白色 `(1,1,1,1)`   | 凝视 Convai 对象时圆点的颜色。                     |
| `IdleColor`   | `FLinearColor`              | `(1,1,1,0)` （透明） | 未凝视任何对象时圆点的颜色。默认 alpha 为 0，因此光标在空闲时不可见。 |
| `DotSize`     | `float` （Slate 单位）          | `6.0`            | 光标方块在未缩放 Slate 单位下的边长。                  |
| `FadeInTime`  | `float` （秒，AdvancedDisplay） | `0.1`            | 从空闲状态淡入活动状态的时长。 `0` 会立即切换。              |
| `FadeOutTime` | `float` （秒，AdvancedDisplay） | `0.25`           | 从活动状态淡出至空闲状态的时长。 `0` 会立即切换。             |

重写 `GazeCursorWidgetClass` 中的 `UConvaiPlayerComponent` 以 Blueprint 子类进行替换。 `SetGazeActive` 运行时仍会在重写版本上调用。

### `UConvaiObjectComponent` — 注视表面

带有以下标签的对象 `UConvaiObjectComponent` 会公开注视相关属性、方法和事件（Details 面板类别 **Convai | Object | Gaze**).

#### 返回的结果

| 属性            | 类型                   | 默认值    | 说明                                                                                                                                                                                                                                                                                                                                                                 |
| ------------- | -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `bGazeable`   | `bool`               | `true` | 此对象是否参与注视检测。设为 `false`时，该对象既不会纳入线迹匹配，也不会纳入点积回退检测。                                                                                                                                                                                                                                                                                                                  |
| `ObjectEntry` | `FConvaiObjectEntry` | —      | 此对象的标识和目标数据。注视范围内的子网格筛选会在 `ObjectEntry.ComponentName` 且 `ObjectEntry.ObjectReference` （Details 面板标签 **对象是**）为 `Specific Component`时使用。请参阅 [组件范围的注视](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/how-gaze-attention-works.md#component-scoped-gaze) 和 [`FConvaiObjectEntry`](#fconvaiobjectentry). |

#### Blueprint 方法

| 方法                         | 签名                                                                                     | 说明                                                                                                                                                                                                                                  |
| -------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GetResolvedComponent`     | `() → USceneComponent*`                                                                | 返回根据 `ObjectEntry.ComponentName`解析出的子组件。每次调用时都会重新验证缓存的匹配项——如果缓存组件的所有者或名称不再符合筛选条件，则会自动重新扫描 Actor 的组件树，因此无需手动调用刷新。以下情况会返回 `nullptr` ： `ObjectEntry.ObjectReference` 不是 `Specific Component`； `ObjectEntry.ComponentName` 为空；或无法解析该名称。 |
| `NotifyGazeBegin`          | `(UConvaiPlayerComponent* Player)`                                                     | 由 `UConvaiPlayerComponent` 在玩家的注视进入此对象时调用。也会触发 `OnGazedIn`。可从 Blueprint 调用此方法，以模拟此组件上的注视进入事件。                                                                                                                                       |
| `NotifyGazeEnd`            | `(UConvaiPlayerComponent* Player)`                                                     | 由 `UConvaiPlayerComponent` 在玩家的注视离开此对象时调用。也会触发 `OnGazedOut`。可从蓝图调用，以模拟注视离开事件。                                                                                                                                                       |
| `NotifyGazeAttentionBegin` | `(UConvaiPlayerComponent* Player, const FString& Text, EC_RunLLMOption ShouldRespond)` | 由 `UConvaiPlayerComponent` 在此对象被提升为“关注中”时调用。还会触发 `OnAttentionGained`。可从蓝图调用，以手动将此对象设为任意聊天机器人的关注对象。                                                                                                                                  |
| `NotifyGazeAttentionEnd`   | `(UConvaiPlayerComponent* Player = nullptr)`                                           | 由 `UConvaiPlayerComponent` 在此对象退出关注状态时调用。还会触发 `OnAttentionLost`。传入 `nullptr` 可在没有特定玩家上下文的情况下解除关注。                                                                                                                                   |

#### 事件

**委托签名：** `FConvaiObjectGazeEvent` — `(UConvaiObjectComponent* ObjectComponent, UConvaiPlayerComponent* PlayerComponent)`

| 事件                  | 触发时机                                                                                                            |
| ------------------- | --------------------------------------------------------------------------------------------------------------- |
| `OnGazedIn`         | 玩家的视线进入此对象时立即触发，早于达到任何关注阈值。                                                                                     |
| `OnGazedOut`        | 玩家的视线离开此对象时立即触发。                                                                                                |
| `OnAttentionGained` | 持续注视达到阈值后，注视系统将此对象提升为关注对象时触发。聊天机器人是否接受是独立的；如果 **启用操作** 处于关闭状态，或 `AttentionSource` 为 `Explicit (Blueprint/C++)`. |
| `OnAttentionLost`   | 此对象退出关注槽位时触发。 `PlayerComponent` 可能为 `nullptr` （目标已销毁时的路径中）——使用前请检查是否为空指针。                                       |

### `UConvaiChatbotComponent` — 关注 API

| 成员                     | 签名                                                                                                                                                                                                                      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `SetObjectInAttention` | `(FConvaiObjectEntry AttentionObject, FString Text = "", EC_RunLLMOption ShouldRespond = Auto, EConvaiContextDelivery Delivery = Send Normally, bool bAddAttentionEvent = true, bool bFlushImmediately = false) → void` | 设置聊天机器人当前关注的对象，并可选提供叙事上下文文本和 LLM 响应选项。将 `AttentionSource` 设为 `Explicit` （或在 `None` ，当 `AttentionObject.Name` 为空时，释放该槽位）。当 `ShouldRespond` 为 `Auto` 或 `Always` 且 `bAddAttentionEvent` 为 `true` （默认值）会暂存一个仅在本次刷新期间存在的事件，其内容为 `"<observer> is paying attention to <object name>"` ——绝不持久化，每次调用触发一次。当 `EnvironmentData.bEnableActions` 为 `false` (**启用操作** （在“细节”面板中），或者对象尚未列入聊天机器人的环境对象列表，或不在连接时发送的对象中时，此设置均不起作用；以上情况都会记录一条警告，指出对象名称和原因。 `bFlushImmediately` 会立即发送更新，而不是将其加入批次。 |
| `AttentionSource`      | `EConvaiAttentionSource` （BlueprintReadOnly、Transient）                                                                                                                                                                  | 最后设置注意力槽的来源。 `None`, `Gaze`，或 `Explicit (Blueprint/C++)`。读取此属性可诊断注意力锁定问题。                                                                                                                                                                                                                                                                                                                                                                                                    |

#### 视线门控方法

以下方法由视线系统在内部调用，也可通过蓝图调用，以实现自定义视线集成。

| 方法                                  | 签名                                                                                                                                                                                                                      | 返回                          | 说明                                                                                                                                                                                                                                                                     |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `TrySetObjectInAttentionFromGaze`   | `(FConvaiObjectEntry AttentionObject, FString Text = "", EC_RunLLMOption ShouldRespond = Auto, EConvaiContextDelivery Delivery = Send Normally, bool bAddAttentionEvent = true, bool bFlushImmediately = false) → bool` | `true` （接受时）， `false` （拒绝时） | 仅当 `EnvironmentData.bEnableActions` 为 `true` 且 `AttentionSource` 为 `None` 或 `Gaze`时，才会设置注意力槽。成功后，会将 `AttentionSource = Gaze`标记为来源。若操作已禁用，或注意力槽被 `false` 调用方锁定，此方法会返回 `Explicit` 并记录一条指出对象名称的警告——调用会被拒绝，而非静默忽略。内部由 `UConvaiPlayerComponent`；向蓝图公开，供必须遵守所有权协议的自定义注视集成使用。 |
| `TryClearObjectInAttentionFromGaze` | `(FConvaiObjectEntry ExpectedObject) → bool`                                                                                                                                                                            | `true` 清除时， `false` 跳过时     | 仅当 `AttentionSource == Gaze` 且当前正在关注的对象与 `ExpectedObject`匹配时，才清除注意力槽。这样可防止过期或延迟到达的注视丢失调用清除已被其他玩家或系统占用的注意力槽。                                                                                                                                                            |

#### `EConvaiAttentionSource`

| 值          | 显示名称       | 含义                                                                                      |
| ---------- | ---------- | --------------------------------------------------------------------------------------- |
| `None`     | 无          | 注意力槽为空。注视系统可以占用它。                                                                       |
| `Gaze`     | 凝视         | 注意力槽由注视系统占用。注视系统可以更新或释放它。                                                               |
| `Explicit` | 显式（蓝图/C++） | 注意力槽被直接的 `SetObjectInAttention` 调用锁定。调用方使用空值清除注意力槽之前，注视调用都会被拒绝。 `SetObjectInAttention`. |

#### `EC_RunLLMOption`

| 值        | 显示名称 | 含义                    |
| -------- | ---- | --------------------- |
| `Auto`   | 自动   | Convai 会据此决定是否生成语音回复。 |
| `Always` | 始终   | 聊天机器人始终生成语音回复。        |
| `Never`  | 从不   | 静默更新注意力；不会触发 LLM 调用。  |

### `FConvaiObjectEntry`

承载于 `UConvaiObjectComponent::ObjectEntry`上的结构体。注视注意力会读取身份字段；对于组件范围的目标，还会读取下方的移动模式字段。

| 字段                | 类型                       | 默认值           | 注视相关性                                                                                                                                  |
| ----------------- | ------------------------ | ------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `Ref`             | `TWeakObjectPtr<AActor>` | `nullptr`     | 此对象条目的 Actor 引用。                                                                                                                       |
| `Name`            | `FString`                | `""`          | 作为 `current_attention_object`发送给 Convai 的对象名称。对象名称不能为空，否则对象无法注册。                                                                       |
| `Description`     | `FString`                | `""`          | Convai 用于理解对象的自然语言描述。                                                                                                                  |
| `ObjectReference` | `EConvaiObjectReference` | `Whole Actor` | 「细节」面板标签 **对象为**。必须设为 `Specific Component` 才能通过 `ComponentName` 将注视范围限定到子网格。使用默认值 `Whole Actor`时，注视会匹配 Actor 的任意基元，不受 `ComponentName`. |
| `ComponentName`   | `FString`                | `""`          | 对子组件名称执行不区分大小写的子字符串筛选。注视仅在以下情况下使用此字段 `ObjectReference` 是 `Specific Component` ，且该名称会解析为以下对象上的组件： `Ref`.                                |

仅用于移动的字段（`AcceptanceRadius`, `SocketOrBoneName`以及相关输出）记录在 [角色动作参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/character-actions/actions-blueprint-reference.md).

### 后续步骤

{% content-ref url="/pages/2f301cf695f654f0b6dc66672ff9462854021237" %}
[注视注意力使用示例](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-usage-examples.md)
{% endcontent-ref %}

{% content-ref url="/pages/ca4f4235151ab1fee69bb58487611f1c6ec30cc6" %}
[排查凝视注意力问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/troubleshoot-gaze-attention.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-reference.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
