SendNapalStreamMessage - 发送NAPal流式消息 - 网络智能服务

A2A流式消息发送

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

nis:SendNapalStreamMessage

create

*全部资源

*

无

请求语法

POST /open/a2a/message/stream HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
Message	object	否	消息体对象，包含用户输入内容及会话上下文信息
ContextId	string	否	会话上下文 ID。首次对话不传，服务端会创建新会话；多轮对话需传入上一次响应中的 contextId 以保持上下文连续	context-xxx
Extensions	array	否	扩展信息列表
	string	否	扩展信息	trace
MessageId	string	否	消息 ID，未传则服务端自动生成	m_msijl2sv_pcfge8r7l
Metadata	object	否	扩展元数据，用于传递额外上下文信息	{}
Parts	array<object>	否	消息内容分片列表，支持多个 Part
	object	否	消息内容分片对象
Data	any	否	结构化数据，用于传递 JSON 格式的结构化内容	{"key":"value"}
Filename	string	否	文件名	report.txt
MediaType	string	否	媒体类型	application/json
Raw	string	否	原始内容，用于传递非文本数据	cmVzZXJ2ZWQ=
Text	string	否	文本内容。用户输入的自然语言指令，如诊断请求、问题咨询等	诊断一下这个实例ngw-xxx
Url	string	否	文件 URL，用于传递文件类内容	https://example.com/file.txt
ReferenceTaskIds	array	否	引用的历史任务 ID 列表，用于上下文关联
	string	否	保留字段，当前接口暂不返回。	task-reserved
Role	string	否	消息角色	user
TaskId	string	否	任务 ID。续聊场景传入上一次任务的 ID	task-xxx
Metadata	object	否	请求附加信息
	string	否	节点元数据	{"tenantId":"t-10001"}
Configuration	object	否	请求配置对象
AcceptedOutputModes	array	否	接受的输出模式。默认 ["text/event-stream"]，表示接受 SSE 流式响应
	string	否	输出模式	text/event-stream
HistoryLength	integer	否	历史消息长度。控制多轮对话时携带的历史消息数量，默认 20	20
ReturnImmediately	boolean	否	是否立即返回。false（默认）表示流式返回，true 表示立即返回任务 ID 后异步处理	false

返回参数

名称	类型	描述	示例值
	object
Message	object	该字段与 Task、TaskStatusUpdate、TaskArtifactUpdate 互斥；返回该字段时不创建任务，流在发送一条 Message 后关闭。当前接口暂不返回该类型，仅用于预留以协议兼容。
ContextId	string	会话上下文 ID	context-07b0**bcc2
Extensions	array	保留字段，当前接口暂不返回。
	string	保留字段，当前接口暂不返回。	reserved
MessageId	string	消息 ID	message-fd6e**9949
Metadata	object	保留字段，当前接口暂不返回。	{}
Parts	array<object>	消息内容分片列表
	object	消息内容分片对象
Data	any	保留字段，当前接口暂不返回。	{}
Filename	string	保留字段，当前接口暂不返回。	reserved.bin
MediaType	string	保留字段，当前接口暂不返回。	application/octet-stream
Raw	string	保留字段，当前接口暂不返回。	cmVzZXJ2ZWQ=
Text	string	文本内容	当前实例运行正常。
Url	string	保留字段，当前接口暂不返回。	https://example.com/reserved.bin
ReferenceTaskIds	array	保留字段，当前接口暂不返回。
	string	保留字段，当前接口暂不返回。	task-reserved
Role	string	消息角色	agent
TaskId	string	保留字段。直返 Message 不创建任务，因此该字段为空；当前接口暂不返回顶层 Message。	task-reserved
RequestId	string	请求 ID	A7F0D6EC-E19E-58AC-AC9F-08036763960F
Task	object	任务信息
Artifacts	array<object>	任务产出物列表
	array<object>	任务产出物对象
ArtifactId	string	产出物唯一标识	output
Description	string	产出物描述	实例健康巡检结果
Extensions	array	保留字段，当前接口暂不返回。
	string	保留字段，当前接口暂不返回。	reserved
Metadata	object	保留字段，当前接口暂不返回。	{}
Name	string	产出物名称	巡检报告
Parts	array<object>	内容分片列表
	object	内容分片对象
Data	any	保留字段，当前接口暂不返回。	{}
Filename	string	保留字段，当前接口暂不返回。	reserved.bin
MediaType	string	保留字段，当前接口暂不返回。	application/octet-stream
Raw	string	保留字段，当前接口暂不返回。	cmVzZXJ2ZWQ=
Text	string	报告文本片段	诊断结果
Url	string	保留字段，当前接口暂不返回。	https://example.com/reserved.bin
ContextId	string	会话上下文 ID。用于多轮对话保持上下文连续	context-07b0**bcc2
History	array<object>	历史消息列表
	array<object>	历史消息
ContextId	string	会话上下文 ID	context-07b0**bcc2
Extensions	array	保留字段，当前接口暂不返回。
	string	保留字段，当前接口暂不返回。	reserved
MessageId	string	消息 ID	message-fd6e**9949
Metadata	object	保留字段，当前接口暂不返回。	{}
Parts	array<object>	消息内容分片列表
	object	消息内容分片对象
Data	any	保留字段，当前接口暂不返回。	{}
Filename	string	保留字段，当前接口暂不返回。	reserved.bin
MediaType	string	保留字段，当前接口暂不返回。	application/octet-stream
Raw	string	保留字段，当前接口暂不返回。	cmVzZXJ2ZWQ=
Text	string	文本内容	诊断一下这个实例ngw-xxx
Url	string	保留字段，当前接口暂不返回。	https://example.com/reserved.bin
ReferenceTaskIds	array	保留字段，当前接口暂不返回。
	string	保留字段，当前接口暂不返回。	task-reserved
Role	string	消息角色	user
TaskId	string	任务 ID	task-38cZ**MAVKu
Id	string	任务 ID	task-38cZ**MAVKu
Metadata	object	扩展元数据，用于传递额外上下文信息	{"usage":"{totalTokens=327672}"}
Status	object	任务状态对象
Message	object	A2A 协议定义的消息对象，包含发送方角色、一个或多个内容分片，以及可选的会话和任务上下文。作为顶层返回字段时，表示智能体直接回复，与 Task、TaskStatusUpdate、TaskArtifactUpdate 互斥；返回后流立即关闭。作为 Status.Message 时，表示与任务状态关联的说明消息。当前接口暂不返回顶层 Message，仅用于协议兼容。
MessageId	string	消息 ID	message-fd6e**9949
Parts	array<object>	消息内容分片列表
	object	消息内容分片对象
Data	any	保留字段，当前接口暂不返回。	{}
Filename	string	保留字段，当前接口暂不返回。	reserved.bin
MediaType	string	保留字段，当前接口暂不返回。	application/octet-stream
Raw	string	保留字段，当前接口暂不返回。	cmVzZXJ2ZWQ=
Text	string	文本内容。用户输入的自然语言指令，如诊断请求、问题咨询等	当前实例运行正常。
Url	string	保留字段，当前接口暂不返回。	https://example.com/reserved.bin
Role	string	消息角色	agent
State	string	任务状态。可选值：TASK_STATE_SUBMITTED（已提交）、TASK_STATE_WORKING（执行中）、TASK_STATE_COMPLETED（已完成）、TASK_STATE_FAILED（已失败）	TASK_STATE_SUBMITTED
Timestamp	string	状态时间戳（ISO 8601 格式）	2026-08-07T06:08:10Z
TaskArtifactUpdate	object	任务产出更新对象
Append	boolean	是否为追加内容。`true` 表示本次 Text 拼接到已有报告内容末尾；`false` 表示覆盖已有内容	true
Artifact	object	产出物对象
ArtifactId	string	产出物唯一标识	output
Description	string	产出物描述	巡检详细报告
Extensions	array	保留字段，当前接口暂不返回。
	string	保留字段，当前接口暂不返回。	reserved
Metadata	object	保留字段，当前接口暂不返回。	{}
Name	string	产出物名称	巡检报告
Parts	array<object>	内容分片列表
	array<object>	内容分片对象
Data	any	保留字段，当前接口暂不返回。	{}
Filename	string	保留字段，当前接口暂不返回。	reserved.bin
MediaType	string	保留字段，当前接口暂不返回。	application/octet-stream
Metadata	object	Metadata
Thought	boolean	是否为思考过程
Raw	string	保留字段，当前接口暂不返回。	cmVzZXJ2ZWQ=
Text	string	报告文本片段	实例状态正常
Url	string	保留字段，当前接口暂不返回。	https://example.com/reserved.bin
ContextId	string	会话上下文 ID	context-07b0**bcc2
LastChunk	boolean	是否为最后一块。`true` 表示报告内容已完整推送完毕，此后不再有新的事件	false
TaskId	string	任务 ID	task-38cZ**MAVKu
TaskStatusUpdate	object	任务状态更新对象
ContextId	string	会话上下文 ID	context-07b0**bcc2
Final	boolean	是否为终态事件。true 表示任务已结束（完成或失败），此后不再推送事件	false
Metadata	object	元数据对象，包含步骤执行信息
Step	object	步骤执行信息
CostTime	integer	步骤执行耗时，单位毫秒 ms。	203
Id	string	步骤唯一标识	30688
IsError	boolean	步骤是否执行出错	false
Name	string	步骤名称	load_skill
Params	any	步骤输入参数	{"skill_id":"239"}
Result	any	步骤执行结果	success
RetryCount	integer	重试次数	1
UiContent	string	前端展示内容	load_skill
Status	object	任务状态对象
Message	object	消息体对象
MessageId	string	消息 ID	message-fd6e**9949
Parts	array<object>	消息内容分片列表
	object	消息内容分片对象
Data	any	保留字段，当前接口暂不返回。	{}
Filename	string	保留字段，当前接口暂不返回。	reserved.bin
MediaType	string	保留字段，当前接口暂不返回。	application/octet-stream
Raw	string	保留字段，当前接口暂不返回。	cmVzZXJ2ZWQ=
Text	string	文本内容	查询流量
Url	string	保留字段，当前接口暂不返回。	https://example.com/reserved.bin
Role	string	消息角色	user
State	string	任务状态。可选值：TASK_STATE_WORKING（执行中）、TASK_STATE_COMPLETED（已完成）、TASK_STATE_FAILED（已失败）、TASK_STATE_CANCELED（已取消）	TASK_STATE_WORKING
Timestamp	string	状态时间戳（ISO 8601 格式）	2026-08-07T06:08:30Z
TaskId	string	任务 ID	task-38cZ**MAVKu

示例

正常返回示例

JSON格式

{
  "Message": {
    "ContextId": "context-07b0**bcc2",
    "Extensions": [
      "reserved"
    ],
    "MessageId": "message-fd6e**9949",
    "Metadata": {},
    "Parts": [
      {
        "Data": "{}",
        "Filename": "reserved.bin",
        "MediaType": "application/octet-stream",
        "Raw": "cmVzZXJ2ZWQ=",
        "Text": "当前实例运行正常。",
        "Url": "https://example.com/reserved.bin"
      }
    ],
    "ReferenceTaskIds": [
      "task-reserved"
    ],
    "Role": "agent",
    "TaskId": "task-reserved"
  },
  "RequestId": "A7F0D6EC-E19E-58AC-AC9F-08036763960F",
  "Task": {
    "Artifacts": [
      {
        "ArtifactId": "output",
        "Description": "实例健康巡检结果",
        "Extensions": [
          "reserved"
        ],
        "Metadata": {},
        "Name": "巡检报告",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-stream",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "诊断结果",
            "Url": "https://example.com/reserved.bin"
          }
        ]
      }
    ],
    "ContextId": "context-07b0**bcc2",
    "History": [
      {
        "ContextId": "context-07b0**bcc2",
        "Extensions": [
          "reserved"
        ],
        "MessageId": "message-fd6e**9949",
        "Metadata": {},
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-stream",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "诊断一下这个实例ngw-xxx",
            "Url": "https://example.com/reserved.bin"
          }
        ],
        "ReferenceTaskIds": [
          "task-reserved"
        ],
        "Role": "user",
        "TaskId": "task-38cZ**MAVKu"
      }
    ],
    "Id": "task-38cZ**MAVKu",
    "Metadata": {
      "usage": "{totalTokens=327672}"
    },
    "Status": {
      "Message": {
        "MessageId": "message-fd6e**9949",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-stream",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "当前实例运行正常。",
            "Url": "https://example.com/reserved.bin"
          }
        ],
        "Role": "agent"
      },
      "State": "TASK_STATE_SUBMITTED",
      "Timestamp": "2026-08-07T06:08:10Z"
    }
  },
  "TaskArtifactUpdate": {
    "Append": true,
    "Artifact": {
      "ArtifactId": "output",
      "Description": "巡检详细报告",
      "Extensions": [
        "reserved"
      ],
      "Metadata": {},
      "Name": "巡检报告",
      "Parts": [
        {
          "Data": "{}",
          "Filename": "reserved.bin",
          "MediaType": "application/octet-stream",
          "Metadata": {
            "Thought": true
          },
          "Raw": "cmVzZXJ2ZWQ=",
          "Text": "实例状态正常",
          "Url": "https://example.com/reserved.bin"
        }
      ]
    },
    "ContextId": "context-07b0**bcc2",
    "LastChunk": false,
    "TaskId": "task-38cZ**MAVKu"
  },
  "TaskStatusUpdate": {
    "ContextId": "context-07b0**bcc2",
    "Final": true,
    "Metadata": {
      "Step": {
        "CostTime": 203,
        "Id": "30688",
        "IsError": false,
        "Name": "load_skill",
        "Params": "{\"skill_id\":\"239\"}",
        "Result": "success",
        "RetryCount": 1,
        "UiContent": "load_skill"
      }
    },
    "Status": {
      "Message": {
        "MessageId": "message-fd6e**9949",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-stream",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "查询流量",
            "Url": "https://example.com/reserved.bin"
          }
        ],
        "Role": "user"
      },
      "State": "TASK_STATE_WORKING",
      "Timestamp": "2026-08-07T06:08:30Z"
    },
    "TaskId": "task-38cZ**MAVKu"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	IllegalParam.IllegalParameter	The parameter is illegal.
400	Forbidden.NoPermission	The authentication result is successful but the verification fails.	鉴权结果成功但验证未通过。
402	IllegalParam.CreditInsufficient	Credit has been exhausted in the current cycle.	当前周期内Credit已耗尽。
403	OperationDenied.AliUid	The specified AliUid is not authorized to operate this resource.	指定的AliUid无权操作该资源。
403	Forbidden.ServiceNotActivated	The NAPal service has not been activated for this account (%s).	该账号(%s)尚未开通NAPal服务。
403	Forbidden.GenerateAccessToken	The user does not have permission to access the (GenerateAccessToken) service.	用户无权限访问(GenerateAccessToken)服务。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。