# 设备智能体配置

设备智能体配置用于按业务场景调整助手的角色、语音交互和设备协作范围。同一部署中的智能体可以共用模型、语音服务和平台连接，同时分别配置识别热词、可用语音工具和反馈话术。

![设备智能体配置总览](../images/docs/usage/agent-configuration/zh/01-config-overview.png)

## 打开配置总览

在设备智能体卡片的更多操作中选择 **配置总览**。页面包含 **设备智能体配置** 和 **A2A 设备绑定** 两个入口。

设备智能体配置支持配置图和列表视图。选择分类查看详情；对话规则、语音识别和回复与反馈通过 **编辑配置** 修改并 **保存**，语音工具的增减直接保存。手机上默认使用列表视图，也可以切换查看方式。

| 分类 | 用途 |
| --- | --- |
| 对话规则 | 按业务场景设定角色与回复方式，并明确时间表达所用的时区 |
| 语音识别 | 为设备名和业务术语添加热词，减少语音输入中的误识别 |
| 语音工具 | 只开放业务所需工具，控制语音助手的工具使用范围 |
| 回复与反馈 | 统一助手身份与反馈话术，让用户了解请求正在处理或等待超时 |
| 设备能力 | 确认设备可查询的数据、可执行的指令和参数要求，便于准备有效请求 |
| A2A 设备绑定 | 指定主控可协作的目标设备，将跨设备协作限定在绑定范围内 |

## 配置示例

以车间设备助手为例，设备与工具需在当前部署中可用。

- **语音巡检**：将[时区](#对话规则)设为 `Asia/Shanghai`；在[语音识别](#语音识别)中添加 `FANUC`、`主轴负载`、`伺服负载`，权重均设为 `3`；[语音工具](#语音工具)选择 `inspect_device`（设备状态查询）。用语音提问“查看机床当前的主轴负载和伺服负载”，验证识别和查询结果。
- **查询反馈**：智能体已有相应配置项时，在[回复与反馈](#回复与反馈)中，将身份回复设为“我是车间设备助手”，**反馈模式** 设为 **模型选择**；在 **分类提示语** 中添加 `device_query`，中文话术设为“正在查询设备状态，请稍等。”，英文话术设为“Checking the device state. Please wait.”，并在 **工具对应分类** 中将 `inspect_device` 关联到该分类。**超时时间（毫秒）** 设为 `15000`。
- **跨设备协作**：为车间主控[绑定](#a2a-设备绑定)已启用 A2A 的冷却泵和排风机，再向主控请求“查看冷却泵和排风机的当前状态”，由主控协调已绑定设备完成查询。

## 对话规则

在 **对话规则** 中查看基本信息，点击 **编辑配置** 调整 **提示词** 和 **时区**，然后保存。

提示词用于说明角色、回复语气和业务偏好，例如：

```text
你是车间设备巡检助手。先汇报设备当前状态，再说明需要关注的异常。回复简洁，数值保留单位。
```

设备能做什么仍由当前模型和访问范围决定。提示词用于调整处理方式，不能增加模型没有声明的设备动作。

时区用于理解今天、明天、几点等时间表达，例如 `Asia/Shanghai`；未指定时使用服务所在时区。时间相关任务见[定时任务](./scheduled-tasks.md)。

## 语音识别

在 **语音识别 → 编辑配置** 中添加容易听错的设备名、人名或业务词，并设置 **识别权重**：普通热词使用 `1`–`5`，新增时默认为 `3`；少量需要特别强调的词可使用 `50`。热词需要支持词表的阿里云识别模型，并在全局语音设置中开启 **使用产品语音识别词表**，支持范围及服务配置见[语音配置](../operate-reference/configuration/voice-config.md#使用智能体热词)。

## 语音工具

在 **语音工具 → 编辑配置** 中搜索并选择工具，点击 **确认添加** 加入列表。添加、移除或恢复允许全部工具后会直接保存，完成后点击 **关闭**。

未限定时使用当前可用的语音工具；选择工具后只允许所选工具；移除全部并确认禁用后，语音对话不能调用工具。此范围只影响语音对话，工具仍需已启用并满足设备访问权限和 A2A 绑定。

## 回复与反馈

在 **回复与反馈 → 编辑配置** 中维护中英文身份回复、模型身份回复、工具等待提示和超时回复，可编辑选项以智能体已有配置为准。

等待提示说明请求正在处理，超时回复说明等待过久，均不代表设备动作已完成或停止；执行结果需另行核对。

## 查看设备能力

**设备能力**显示当前接入方式提供的属性、指令和事件，包括可写性、参数、类型和取值要求。这里用于确认智能体可以理解和调用哪些能力，当前为只读视图。

需要调整能力时，通过[定义设备智能体](./create-agent.md)的建模入口，或当前 IoT 平台的模型管理入口修改。接入规则见[IoT 平台集成](../integrations/iot-platform.md)。

## A2A 设备绑定

在 **A2A 设备绑定** 中点击 **配置设备绑定**，选择主控设备及已启用 A2A 的目标设备智能体和设备，点击 **确认添加** 后保存。每台主控的绑定范围独立；能力发布和协作方式见[A2A 多智能体协作](./a2a.md)。

## 保存与验证

保存后重新打开对应分类，确认内容。语音工具与反馈设置可以通过下一次提问检查；识别热词在下一次语音连接中验证。

如果页面提示配置已在别处修改，请重新打开并检查最新内容后再保存。