SendNapalStreamMessage - Network Intelligence Service - Alibaba Cloud Documentation Center

Mengirim Paket aliran A2A.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

nis:SendNapalStreamMessage

create

*Semua resource.

*

None

Sintaks permintaan

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

Parameter permintaan

Parameter	Type	Required	Description	Example
Message	object	No	Objek body Paket yang berisi input pengguna dan informasi konteks percakapan.
ContextId	string	No	ID konteks percakapan. Jangan tentukan parameter ini untuk percakapan pertama. Server akan membuat percakapan baru. Untuk percakapan multi-turn, tentukan contextId dari tanggapan sebelumnya untuk mempertahankan kesinambungan konteks.	context-xxx
Extensions	array	No	Daftar informasi ekstensi.
	string	No	Informasi ekstensi.	trace
MessageId	string	No	ID Paket. Jika tidak ditentukan, server akan membuatnya secara otomatis.	m_msijl2sv_pcfge8r7l
Metadata	object	No	Metadata tambahan yang digunakan untuk meneruskan informasi konteks tambahan.	{}
Parts	array<object>	No	Daftar bagian konten Paket. Mendukung beberapa bagian.
	object	No	Objek bagian konten Paket.
Data	any	No	Data terstruktur yang digunakan untuk meneruskan konten terstruktur berformat JSON.	{"key":"value"}
Filename	string	No	Nama file.	report.txt
MediaType	string	No	Tipe media.	application/json
Raw	string	No	Konten mentah yang digunakan untuk meneruskan data non-teks.	cmVzZXJ2ZWQ=
Text	string	No	Konten teks. Instruksi bahasa alami yang dimasukkan oleh pengguna, seperti permintaan diagnostik atau konsultasi pertanyaan.	Diagnosis instans ini ngw-xxx
Url	string	No	URL file yang digunakan untuk meneruskan konten bertipe file.	https://example.com/file.txt
ReferenceTaskIds	array	No	Daftar ID tugas historis yang direferensikan yang digunakan untuk asosiasi konteks.
	string	No	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	Tugas-reserved
Role	string	No	Peran Paket.	user
TaskId	string	No	ID tugas. Tentukan ID tugas sebelumnya untuk percakapan lanjutan.	Tugas-xxx
Metadata	object	No	Informasi permintaan tambahan.
	string	No	Metadata node.	{"tenantId":"t-10001"}
Configuration	object	No	Objek konfigurasi permintaan.
AcceptedOutputModes	array	No	Mode keluaran yang diterima. Nilai default: ["text/event-stream"], yang menunjukkan bahwa tanggapan aliran SSE diterima.
	string	No	Mode keluaran.	text/event-aliran
HistoryLength	integer	No	Panjang riwayat Paket. Mengontrol jumlah Paket historis yang dibawa selama percakapan multi-turn. Nilai default: 20.	20
ReturnImmediately	boolean	No	Apakah akan mengembalikan segera. Nilai valid: false (default): Mengembalikan tanggapan dalam mode aliran. true: Mengembalikan ID tugas segera dan memproses permintaan secara asinkron.	false

Elemen respons

Element	Type	Description	Example
	object
Message	object	Bidang ini saling eksklusif dengan Task, TaskStatusUpdate, dan TaskArtifactUpdate. Ketika bidang ini dikembalikan, tidak ada tugas yang dibuat, dan aliran ditutup setelah mengirimkan satu Message. Bidang ini saat ini tidak dikembalikan oleh operasi ini dan dicadangkan untuk kompatibilitas protokol.
ContextId	string	ID konteks percakapan.	context-07b0**bcc2
Extensions	array	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.
	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved
MessageId	string	ID Paket.	Paket-fd6e**9949
Metadata	object	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Parts	array<object>	Daftar bagian konten Paket.
	object	Objek bagian konten Paket.
Data	any	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Filename	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved.bin
MediaType	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	application/octet-aliran
Raw	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	cmVzZXJ2ZWQ=
Text	string	Konten teks.	Instans saat ini berjalan normal
Url	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	https://example.com/reserved.bin
ReferenceTaskIds	array	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.
	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	Tugas-reserved
Role	string	Peran Paket.	agent
TaskId	string	Bidang yang dicadangkan. Message yang dikembalikan secara langsung tidak membuat tugas, sehingga bidang ini kosong. Operasi ini saat ini tidak mengembalikan Message tingkat atas.	Tugas-reserved
RequestId	string	ID permintaan.	A7F0D6EC-E19E-58AC-AC9F-08036763960F
Task	object	Informasi tugas.
Artifacts	array<object>	Daftar artefak tugas.
	array<object>	Objek artefak tugas.
ArtifactId	string	Pengenal unik artefak.	output
Description	string	Deskripsi artefak.	Hasil pemeriksaan kesehatan instans
Extensions	array	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.
	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved
Metadata	object	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Name	string	Nama artefak.	Laporan pemeriksaan
Parts	array<object>	Daftar bagian konten.
	object	Objek bagian konten.
Data	any	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Filename	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved.bin
MediaType	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	application/octet-aliran
Raw	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	cmVzZXJ2ZWQ=
Text	string	Fragmen teks laporan.	Hasil diagnostik
Url	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	https://example.com/reserved.bin
ContextId	string	ID konteks percakapan. ID ini digunakan untuk mempertahankan kesinambungan konteks di seluruh percakapan multi-putaran.	context-07b0**bcc2
History	array<object>	Daftar Paket historis.
	array<object>	Paket historis.
ContextId	string	ID konteks percakapan.	context-07b0**bcc2
Extensions	array	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.
	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved
MessageId	string	ID Paket.	Paket-fd6e**9949
Metadata	object	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Parts	array<object>	Daftar bagian konten Paket.
	object	Objek bagian konten Paket.
Data	any	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Filename	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved.bin
MediaType	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	application/octet-aliran
Raw	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	cmVzZXJ2ZWQ=
Text	string	Konten teks.	Diagnosis instans ini ngw-xxx
Url	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	https://example.com/reserved.bin
ReferenceTaskIds	array	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.
	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	task-reserved
Role	string	Peran Paket.	user
TaskId	string	ID tugas.	task-38cZ**MAVKu
Id	string	ID tugas.	task-38cZ**MAVKu
Metadata	object	Metadata tambahan yang digunakan untuk meneruskan informasi konteks tambahan.	{"usage":"{totalTokens=327672}"}
Status	object	Objek status tugas.
Message	object	Objek Paket yang didefinisikan oleh protokol A2A. Berisi peran pengirim, satu atau beberapa bagian konten, serta konteks sesi dan tugas opsional. Ketika dikembalikan sebagai bidang tingkat atas, ini menunjukkan balasan langsung dari agen dan saling eksklusif dengan Task, TaskStatusUpdate, dan TaskArtifactUpdate. Aliran ditutup segera setelah bidang ini dikembalikan. Ketika dikembalikan sebagai Status.Message, ini mewakili Paket deskriptif yang terkait dengan status tugas. Operasi ini saat ini tidak mengembalikan Message tingkat atas. Bidang ini hanya dicadangkan untuk kompatibilitas protokol.
MessageId	string	ID Paket.	message-fd6e**9949
Parts	array<object>	Daftar bagian konten Paket.
	object	Objek bagian konten Paket.
Data	any	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Filename	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved.bin
MediaType	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	application/octet-stream
Raw	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	cmVzZXJ2ZWQ=
Text	string	Konten teks. Instruksi bahasa alami yang dimasukkan oleh pengguna, seperti permintaan diagnostik atau konsultasi pertanyaan.	Instans saat ini berjalan normal
Url	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	https://example.com/reserved.bin
Role	string	Peran Paket.	agent
State	string	Status tugas. Nilai valid: TASK_STATE_SUBMITTED: Tugas telah dikirimkan. TASK_STATE_WORKING: Tugas sedang dieksekusi. TASK_STATE_COMPLETED: Tugas telah selesai. TASK_STATE_FAILED: Tugas telah gagal.	TASK_STATE_SUBMITTED
Timestamp	string	Stempel waktu status dalam format ISO 8601.	2026-08-07T06:08:10Z
TaskArtifactUpdate	object	Objek pembaruan artefak tugas.
Append	boolean	Apakah akan menambahkan konten. Nilai `true` menunjukkan bahwa Text dalam pembaruan ini ditambahkan ke akhir konten laporan yang ada. Nilai `false` menunjukkan bahwa konten yang ada ditimpa.	true
Artifact	object	Objek artefak.
ArtifactId	string	Pengenal unik artefak.	output
Description	string	Deskripsi artefak.	Laporan inspeksi terperinci
Extensions	array	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.
	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved
Metadata	object	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Name	string	Nama artefak.	Laporan pemeriksaan
Parts	array<object>	Daftar bagian konten.
	array<object>	Objek bagian konten.
Data	any	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Filename	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved.bin
MediaType	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	application/octet-stream
Metadata	object	Metadata.
Thought	boolean	Apakah konten merupakan proses berpikir.
Raw	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	cmVzZXJ2ZWQ=
Text	string	Fragmen teks laporan.	Status instans normal
Url	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	https://example.com/reserved.bin
ContextId	string	ID konteks percakapan.	context-07b0**bcc2
LastChunk	boolean	Apakah ini adalah chunk terakhir. Nilai `true` menunjukkan bahwa konten laporan telah sepenuhnya dikirim dan tidak ada event lain yang akan mengikuti.	false
TaskId	string	ID tugas.	task-38cZ**MAVKu
TaskStatusUpdate	object	Objek pembaruan status Tugas.
ContextId	string	ID konteks percakapan.	context-07b0**bcc2
Final	boolean	Apakah ini adalah event status yang diinginkan. Nilai true menunjukkan bahwa Tugas telah berakhir (selesai atau gagal) dan tidak ada event lain yang akan dikirim.	false
Metadata	object	Objek metadata yang berisi informasi eksekusi langkah.
Step	object	Informasi eksekusi langkah.
CostTime	integer	Durasi eksekusi langkah. Unit: milidetik (ms).	203
Id	string	Pengidentifikasi unik langkah.	30688
IsError	boolean	Apakah langkah mengalami error selama eksekusi.	false
Name	string	Nama langkah.	load_skill
Params	any	Parameter input langkah.	{"skill_id":"239"}
Result	any	Hasil eksekusi langkah.	success
RetryCount	integer	Jumlah percobaan ulang.	1
UiContent	string	Konten tampilan antarmuka depan.	load_skill
Status	object	Objek status tugas.
Message	object	Objek badan Paket.
MessageId	string	ID Paket.	Paket-fd6e**9949
Parts	array<object>	Daftar bagian konten Paket.
	object	Objek bagian konten Paket.
Data	any	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	{}
Filename	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	reserved.bin
MediaType	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	application/octet-aliran
Raw	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	cmVzZXJ2ZWQ=
Text	string	Konten teks.	Query traffic
Url	string	Bidang yang dicadangkan. Parameter ini tidak dikembalikan oleh operasi saat ini.	https://example.com/reserved.bin
Role	string	Peran Paket.	user
State	string	Status Tugas. Nilai valid: TASK_STATE_WORKING (Berjalan), TASK_STATE_COMPLETED (selesai), TASK_STATE_FAILED (gagal), TASK_STATE_CANCELED (dibatalkan).	TASK_STATE_WORKING
Timestamp	string	Stempel waktu status dalam format ISO 8601.	2026-08-07T06:08:30Z
TaskId	string	ID tugas.	Tugas-38cZ**MAVKu

Contoh

Respons sukses

JSONformat

{
  "Message": {
    "ContextId": "context-07b0**bcc2",
    "Extensions": [
      "reserved"
    ],
    "MessageId": "message-fd6e**9949",
    "Metadata": {},
    "Parts": [
      {
        "Data": "{}",
        "Filename": "reserved.bin",
        "MediaType": "application/octet-stream",
        "Raw": "cmVzZXJ2ZWQ=",
        "Text": "Instans saat ini berjalan normal",
        "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": "Hasil inspeksi kesehatan instans",
        "Extensions": [
          "reserved"
        ],
        "Metadata": {},
        "Name": "Laporan inspeksi",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-aliran",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "Hasil diagnostik",
            "Url": "https://example.com/reserved.bin"
          }
        ]
      }
    ],
    "ContextId": "context-07b0**bcc2",
    "History": [
      {
        "ContextId": "context-07b0**bcc2",
        "Extensions": [
          "reserved"
        ],
        "MessageId": "Paket-fd6e**9949",
        "Metadata": {},
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-aliran",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "Diagnose this instance ngw-xxx",
            "Url": "https://example.com/reserved.bin"
          }
        ],
        "ReferenceTaskIds": [
          "Tugas-reserved"
        ],
        "Role": "user",
        "TaskId": "Tugas-38cZ**MAVKu"
      }
    ],
    "Id": "Tugas-38cZ**MAVKu",
    "Metadata": {
      "usage": "{totalTokens=327672}"
    },
    "Status": {
      "Message": {
        "MessageId": "Paket-fd6e**9949",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-aliran",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "Instans saat ini berjalan normal",
            "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": "Laporan inspeksi terperinci",
      "Extensions": [
        "reserved"
      ],
      "Metadata": {},
      "Name": "Laporan inspeksi",
      "Parts": [
        {
          "Data": "{}",
          "Filename": "reserved.bin",
          "MediaType": "application/octet-aliran",
          "Metadata": {
            "Thought": false
          },
          "Raw": "cmVzZXJ2ZWQ=",
          "Text": "Status instans normal",
          "Url": "https://example.com/reserved.bin"
        }
      ]
    },
    "ContextId": "context-07b0**bcc2",
    "LastChunk": false,
    "TaskId": "Tugas-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": "message-fd6e**9949",
        "Parts": [
          {
            "Data": "{}",
            "Filename": "reserved.bin",
            "MediaType": "application/octet-stream",
            "Raw": "cmVzZXJ2ZWQ=",
            "Text": "Kueri lalu lintas",
            "Url": "https://example.com/reserved.bin"
          }
        ],
        "Role": "user"
      },
      "State": "TASK_STATE_WORKING",
      "Timestamp": "2026-08-07T06:08:30Z"
    },
    "TaskId": "task-38cZ**MAVKu"
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalParam.IllegalParameter	The parameter is illegal.
400	Forbidden.NoPermission	The authentication result is successful but the verification fails.	Otentikasi berhasil, tetapi verifikasi gagal.
402	IllegalParam.CreditInsufficient	Credit has been exhausted in the current cycle.	Kredit telah habis dalam siklus saat ini.
403	OperationDenied.AliUid	The specified AliUid is not authorized to operate this resource.	Pengguna (%s) tidak memiliki izin untuk melakukan operasi ini.
403	Forbidden.ServiceNotActivated	The NAPal service has not been activated for this account (%s).	Akun (%s) belum mengaktifkan layanan NAPal.
403	Forbidden.GenerateAccessToken	The user does not have permission to access the (GenerateAccessToken) service.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.