目录

变量

概述

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

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

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

用户发送“查明天南京的天气”:

小艺向Agent Server请求的报文如下,kind为message的结构下,parts.data.variables.systemVariables中携带系统变量的值。详细的协议描述见设备上下文参数指令说明。

{
  "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"
}