其中,【系统变量】是用户在使用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"
}