SendNapalStreamMessage - Network Intelligence Service - Alibaba Cloud ドキュメントセンター

A2A ストリームメッセージを送信します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

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>	任意	メッセージ本文パーツのリスト。複数のパーツがサポートされています。
	object	任意	メッセージ本文パーツオブジェクト。
Data	any	任意	JSON フォーマットの構造化コンテンツを渡すために使用される構造化データ。	{"key":"値"}
Filename	string	任意	ファイル名。	レポート.txt
MediaType	string	任意	メディアタイプ。	application/json
Raw	string	任意	非テキストデータを渡すために使用される未加工コンテンツ。	cmVzZXJ2ZWQ=
Text	string	任意	テキストコンテンツ。診断リクエストや質問など、ユーザーが入力する自然言語の命令。	このインスタンス ngw-xxx を診断してください
Url	string	任意	ファイルタイプのコンテンツを渡すために使用されるファイル URL。	https://example.com/file.txt
ReferenceTaskIds	array	任意	コンテキストの関連付けに使用される、参照された履歴タスク ID のリスト。
	string	任意	予約フィールド。このパラメーターは現在の操作では返されません。	タスク-reserved
Role	string	任意	メッセージのロール。	user
TaskId	string	任意	タスク ID。フォローアップ会話の場合は、前のタスクの ID を指定します。	タスク-xxx
Metadata	object	任意	追加のリクエストフォーマット。
	string	任意	ノードメタデータ。	{"tenantId":"t-10001"}
Configuration	object	任意	リクエスト構成オブジェクト。
AcceptedOutputModes	array	任意	許可された出力モード。デフォルト値: ["text/event-stream"]。SSE イベントストリーム応答が許可されることを示します。
	string	任意	出力モード。	text/イベント-ストリーム
HistoryLength	integer	任意	履歴メッセージの長さ。マルチターン会話中に保持される履歴メッセージの数を制御します。デフォルト値: 20。	20
ReturnImmediately	boolean	任意	すぐに返すかどうかを指定します。有効な値: false (デフォルト): ストリームモードで応答を返します。 true: タスク ID をすぐに返し、リクエストを非同期で処理します。	false

レスポンスフィールド

フィールド	型	説明	例
	object
Message	object	このフィールドは、Task、TaskStatusUpdate、および TaskArtifactUpdate と相互排他です。このフィールドが返される場合、タスクは作成されず、1 つのメッセージを送信した後にストリームが閉じます。このフィールドは現在この操作では返されず、プロトコルの互換性のために予約されています。
ContextId	string	会話コンテキスト ID。	context-07b0**bcc2
Extensions	array	予約フィールド。このパラメーターは現在の操作では返されません。
	string	予約フィールド。このパラメーターは現在の操作では返されません。	reserved
MessageId	string	メッセージ ID。	メッセージ-fd6e**9949
Metadata	object	予約フィールド。このパラメーターは現在の操作では返されません。	{}
Parts	array<object>	メッセージ本文パートのリスト。
	object	メッセージ本文パーツオブジェクト。
Data	any	予約フィールド。このパラメーターは現在の操作では返されません。	{}
Filename	string	予約フィールド。このパラメーターは現在の操作では返されません。	reserved.bin
MediaType	string	予約フィールド。このパラメーターは現在の操作では返されません。	application/octet-ストリーム
Raw	string	予約フィールド。このパラメーターは現在の操作では返されません。	cmVzZXJ2ZWQ=
Text	string	テキストコンテンツ。	現在のインスタンスは正常に実行中です
Url	string	予約フィールド。このパラメーターは現在の操作では返されません。	https://example.com/reserved.bin
ReferenceTaskIds	array	予約フィールド。このパラメーターは現在の操作では返されません。
	string	予約フィールド。このパラメーターは現在の操作では返されません。	タスク-reserved
Role	string	メッセージのロール。	エージェント
TaskId	string	予約済みフィールド。直接返されるメッセージはタスクを作成しないため、このフィールドは空です。この操作では現在、トップレベルのメッセージは返されません。	タスク-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-ストリーム
Raw	string	予約フィールド。このパラメーターは現在の操作では返されません。	cmVzZXJ2ZWQ=
Text	string	レポートテキストフラグメント。	診断結果
Url	string	予約フィールド。このパラメーターは現在の操作では返されません。	https://example.com/reserved.bin
ContextId	string	会話コンテキスト ID。この ID は、マルチターン会話全体でコンテキストの継続性を維持するために使用されます。	context-07b0**bcc2
History	array<object>	履歴メッセージのリスト。
	array<object>	履歴メッセージ。
ContextId	string	会話コンテキスト ID。	context-07b0**bcc2
Extensions	array	予約フィールド。このパラメーターは現在の操作では返されません。
	string	予約フィールド。このパラメーターは現在の操作では返されません。	reserved
MessageId	string	メッセージ ID。	メッセージ-fd6e**9949
Metadata	object	予約フィールド。このパラメーターは現在の操作では返されません。	{}
Parts	array<object>	メッセージ本文パートのリスト。
	object	メッセージ本文パーツオブジェクト。
Data	any	予約フィールド。このパラメーターは現在の操作では返されません。	{}
Filename	string	予約フィールド。このパラメーターは現在の操作では返されません。	reserved.bin
MediaType	string	予約フィールド。このパラメーターは現在の操作では返されません。	application/octet-ストリーム
Raw	string	予約フィールド。このパラメーターは現在の操作では返されません。	cmVzZXJ2ZWQ=
Text	string	テキストコンテンツ。	このインスタンス ngw-xxx を診断してください
Url	string	予約フィールド。このパラメーターは現在の操作では返されません。	https://example.com/reserved.bin
ReferenceTaskIds	array	予約フィールド。このパラメーターは現在の操作では返されません。
	string	予約フィールド。このパラメーターは現在の操作では返されません。	タスク-reserved
Role	string	メッセージのロール。	user
TaskId	string	タスク ID。	タスク-38cZ**MAVKu
Id	string	タスク ID。	タスク-38cZ**MAVKu
Metadata	object	追加のコンテキスト情報を渡すために使用される拡張メタデータ。	{"usage":"{totalTokens=327672}"}
Status	object	タスクステータスオブジェクト。
Message	object	A2A プロトコルで定義されたメッセージオブジェクト。送信者のロール、1 つ以上のコンテンツパート、およびオプションの会話とタスクのコンテキストが含まれます。トップレベルのフィールドとして返される場合、エージェントからの直接の応答を示し、Task、TaskStatusUpdate、および TaskArtifactUpdate と相互排他です。このフィールドが返された直後にストリームが閉じます。Status.Message として返される場合、タスクステータスに関連付けられた説明メッセージを表します。この操作では現在、トップレベルのメッセージは返されません。このフィールドは、プロトコルの互換性のためだけに予約されています。
MessageId	string	メッセージ ID。	メッセージ-fd6e**9949
Parts	array<object>	メッセージ本文パートのリスト。
	object	メッセージ本文パーツオブジェクト。
Data	any	予約フィールド。このパラメーターは現在の操作では返されません。	{}
Filename	string	予約フィールド。このパラメーターは現在の操作では返されません。	reserved.bin
MediaType	string	予約フィールド。このパラメーターは現在の操作では返されません。	application/octet-ストリーム
Raw	string	予約フィールド。このパラメーターは現在の操作では返されません。	cmVzZXJ2ZWQ=
Text	string	テキストコンテンツ。診断リクエストや質問など、ユーザーが入力する自然言語の命令。	現在のインスタンスは正常に実行中です
Url	string	予約フィールド。このパラメーターは現在の操作では返されません。	https://example.com/reserved.bin
Role	string	メッセージのロール。	エージェント
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` の場合、この更新のテキストが既存のレポートコンテンツの末尾に追加されることを示します。値が `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-ストリーム
Metadata	object	メタデータ。
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。	タスク-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。	メッセージ-fd6e**9949
Parts	array<object>	メッセージ本文のパーツのリスト。
	object	メッセージ本文パーツオブジェクト。
Data	any	予約フィールド。このパラメーターは現在の操作では返されません。	{}
Filename	string	予約フィールド。このパラメーターは現在の操作では返されません。	reserved.bin
MediaType	string	予約フィールド。このパラメーターは現在の操作では返されません。	application/octet-ストリーム
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。	タスク-38cZ**MAVKu

例

成功レスポンス

JSONJSON

{
  "Message": {
    "ContextId": "context-07b0**bcc2",
    "Extensions": [
      "reserved"
    ],
    "MessageId": "メッセージ-fd6e**9949",
    "Metadata": {},
    "Parts": [
      {
        "Data": "{}",
        "Filename": "reserved.bin",
        "MediaType": "application/octet-ストリーム",
        "Raw": "cmVzZXJ2ZWQ=",
        "Text": "現在のインスタンスは正常に実行中です",
        "Url": "https://example.com/reserved.bin"
      }
    ],
    "ReferenceTaskIds": [
      "タスク-reserved"
    ],
    "Role": "エージェント",
    "TaskId": "タスク-reserved"
  },
  "RequestId": "A7F0D6EC-E19E-58AC-AC9F-08036763960F",
  "Task": {
    "Artifacts": [
      {
        "ArtifactId": "output",
        "Description": "インスタンスのヘルスチェック結果",
        "Extensions": [
          "reserved"
        ],
        "Metadata": {},
        "Name": "検査レポート",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-ストリーム",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "診断結果",
            "Url": "https://example.com/reserved.bin"
          }
        ]
      }
    ],
    "ContextId": "context-07b0**bcc2",
    "History": [
      {
        "ContextId": "context-07b0**bcc2",
        "Extensions": [
          "reserved"
        ],
        "MessageId": "メッセージ-fd6e**9949",
        "Metadata": {},
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-ストリーム",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "Diagnose this instance ngw-xxx",
            "Url": "https://example.com/reserved.bin"
          }
        ],
        "ReferenceTaskIds": [
          "タスク-reserved"
        ],
        "Role": "user",
        "TaskId": "タスク-38cZ**MAVKu"
      }
    ],
    "Id": "タスク-38cZ**MAVKu",
    "Metadata": {
      "usage": "{totalTokens=327672}"
    },
    "Status": {
      "Message": {
        "MessageId": "メッセージ-fd6e**9949",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-ストリーム",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "現在のインスタンスは正常に実行中です",
            "Url": "https://example.com/reserved.bin"
          }
        ],
        "Role": "エージェント"
      },
      "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-ストリーム",
          "Metadata": {
            "Thought": false
          },
          "Raw": "cmVzZXJ2ZWQ=",
          "Text": "インスタンスのステータスは正常です",
          "Url": "https://example.com/reserved.bin"
        }
      ]
    },
    "ContextId": "context-07b0**bcc2",
    "LastChunk": false,
    "TaskId": "タスク-38cZ**MAVKu"
  },
  "TaskStatusUpdate": {
    "ContextId": "context-07b0**bcc2",
    "Final": false,
    "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": "メッセージ-fd6e**9949",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-ストリーム",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "トラフィックを照会",
            "Url": "https://example.com/reserved.bin"
          }
        ],
        "Role": "user"
      },
      "State": "TASK_STATE_WORKING",
      "Timestamp": "2026-08-07T06:08:30Z"
    },
    "TaskId": "タスク-38cZ**MAVKu"
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
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.	現在のサイクル内でクレジットがすべて消費されました。
403	OperationDenied.AliUid	The specified AliUid is not authorized to operate this resource.	ユーザー (%s) には、この操作を実行する権限がありません。
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。