# 变量

## 概述

可通过在变量配置项中打开对应变量的开关，使Agent Server端获取受控系统的上下文信息。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7d/v3/EbCMzCdAQDSWXOZUJ1xVEg/zh-cn_image_0000002765299241.png?HW-CC-KV=V1&HW-CC-Date=20261015T102400Z&HW-CC-Expire=31536000000&HW-CC-Sign=6C5DB4EF2CB5CF855978BECC964CD87197E59E9F381DC5D371C4DD7955C6EC96 "点击放大")

其中，【系统变量】是用户在使用Agent时自动产生的数据。系统变量仅支持读取，开发者不可对【系统变量】进行新增、修改、删除操作。开关默认为关闭状态，开发者可以根据实际业务需求开启使用必要的【系统变量】。当前平台提供了设备标识符、设备语言等系统变量，可以按需使用。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d6/v3/kwKChKymROW6jQM_OQgPfA/zh-cn_image_0000002735939670.gif?HW-CC-KV=V1&HW-CC-Date=20261015T102400Z&HW-CC-Expire=31536000000&HW-CC-Sign=43059F3FD20B3551B22EA4CE79F7A0954316172188B1FBCB3C75F32558ED58B7 "点击放大")

下面是将Agent的变量中打开了如下系统变量的开关，用户发送Query时，小艺向Agent Server请求的报文中的示例：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e2/v3/qtni4WWeRMW07o55Ug-BAA/zh-cn_image_0000002748977258.png?HW-CC-KV=V1&HW-CC-Date=20261015T102400Z&HW-CC-Expire=31536000000&HW-CC-Sign=A628D62C8EC30BC5D83E5B4A33AAAF6DAF61EC006A71AD3957CC1FD1DADF45FB "点击放大")

用户发送"查明天南京的天气"：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fb/v3/isK2NkCKRUOF9KDSDzIpTA/zh-cn_image_0000002749142102.png?HW-CC-KV=V1&HW-CC-Date=20261015T102400Z&HW-CC-Expire=31536000000&HW-CC-Sign=7E7B8B60988BB01B7958289B8D59EA5F25E7AEE94268B6D21C6D7C2DCC6489C7 "点击放大")

小艺向Agent Server请求的报文如下，kind为message的结构下，parts.data.variables.systemVariables中携带系统变量的值。详细的协议描述见[设备上下文参数指令说明](https://developer.huawei.com/consumer/cn/doc/service/agent2agent-context-0000002733303290)。

```screen
{
  "conversationId": "66ab2b954ca241c89efe48882adf16db",
  "deviceId": "0181ec2d-cea6-793b-ab22-e974ab724c03",
  "id": "3482180a-0b55-4b73-b38a-3732c7ce7189&4&8a39&0",
  "jsonrpc": "2.0",
  "method": "message/stream",
  "params": {
    "id": "3482180a-0b55-4b73-b38a-3732c7ce7189&4&8a39&0",
    "message": {
      "kind": "message",
      "messageId": "3482180a-0b55-4b73-b38a-3732c7ce7189&4&8a39&0",
      "parts": [
        {
          "data": {
            "variables": {
              "systemVariables": {
                "agent_framework_kit_context": "",
                "agent_id": "agentde0577fea81940d6a98dd0d84bf47d60",
                "agent_instance_id": "agentde0577fea81940d6a98dd0d84bf47d60_DEV",
                "app_ver": "11.7.7.399",
                "card_info": "null",
                "conversation_id": "66ab2b954ca241c89efe48882adf16db",
                "device_id": "0181ec2d-cea6-793b-ab22-e974ab724c03",
                "device_type": "phone",
                "display_version": "BRA-AL00 6.1.0.135(SP8C00E120R8P11)",
                "foreground_apps": "[{\"activityName\":\"VoiceAbility\",\"isFocus\":true,\"name\":\"小艺服务\",\"packageName\":\"com.huawei.*******\",\"version\":\"11.7.7.399\"}]",
                "hilink_device_id": "",
                "language": "zh_CN",
                "market_name": "HUAWEI Mate 60",
                "odid": "0181ec2d-cea6-793b-ab22-e974ab724c03",
                "pseudo_device_id": "8c258c02425beb6b0bd99fbe45a6292626d9142f7b757822ee456912a299b9ec",
                "push_id": "98313729787889b7e10621a1b649bddb28413479fb240a59cfe3fa0da040d2ba",
                "relate_foreground_apps": "[]",
                "sdk_api_version": "24",
                "sender_agent_id": "",
                "time_zone": "GMT+08:00",
                "trace_id": "3482180a-0b55-4b73-b38a-3732c7ce7189-4-8a39-0",
                "uid": "150086000000102917"
              }
            }
          },
          "kind": "data"
        },
        {
          "kind": "text",
          "text": "查明天南京的天气"
        }
      ],
      "role": "user"
    },
    "sessionId": "66ab2b954ca241c89efe48882adf16db"
  },
  "sessionId": "3482180a-0b55-4b73-b38a-3732c7ce7189"
}
```