All Products
Search

This Product

    DataWorks:PromptAgentSession

    Document Center

    DataWorks:PromptAgentSession

    Last Updated:Jun 11, 2026

    Mengirim prompt ke sesi yang sudah ada dan melakukan streaming respons agen.

    Deskripsi operasi

    Permintaan

    • API ini mengirim prompt pengguna ke ID sesi yang ditentukan dan melakukan streaming respons agen melalui SSE (Server-Sent Events).

    • Respons dapat mencakup potongan pesan, proses pemikiran, dan pembaruan status pemanggilan alat.

    • Jika sesi yang ditentukan tidak ada, API mengembalikan error 400 dalam frame error SSE.

    • Field stopReason menunjukkan alasan agen mengakhiri giliran.

    • Anda dapat menggunakan beberapa jenis blok konten dalam prompt, seperti teks dan tautan unduhan file OSS.

    • Anda dapat memberikan metadata tambahan dalam parameter Meta untuk meneruskan lebih banyak konteks ke server.

    • Konten respons sesuai dengan spesifikasi Agent Client Protocol (ACP) sumber terbuka. Untuk informasi selengkapnya, lihat https://agentclientprotocol.com

    • **Tinjau metode penagihan dan harga untuk Data Agent sebelum Anda menggunakan API ini**: https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing

    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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Sintaks permintaan

    POST  HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Jsonrpc

    string

    No

    Versi JSON-RPC. Nilai tetap: 2.0.

    2.0
    Id

    string

    No

    ID yang dikirimkan oleh pemanggil. Nilai dikembalikan apa adanya dalam respons.

    1021418411
    Params

    object

    No

    Parameter bisnis.

    SessionId

    string

    No

    ID sesi target. Jika sesi tidak ada, frame error SSE akan dikembalikan.

    sess_0f12abc34
    Prompt

    array<object>

    No

    Array blok konten pesan pengguna. Untuk informasi selengkapnya, lihat https://agentclientprotocol.com/protocol/content

    array<object>

    No

    Type

    string

    No

    Jenis blok konten.

    目前支持：text，resource_link
    Text

    string

    No

    Konten teks.

    Type=text下生效，示例值：近 7 天销售额
    Uri

    string

    No

    URI file.

    Type= resource_link下生效，示例值：oss://${bucket}/${ossKey}
    Name

    string

    No

    Nama file.

    Type= resource_link下生效，示例值：xxx.csv
    MimeType

    string

    No

    Jenis MIME file.

    Type= resource_link下生效，示例值：text/csv‌
    Size

    integer

    No

    Ukuran file. Satuan: byte.

    Type= resource_link下生效，示例值：1231231
    Title

    string

    No

    Judul file.

    Type= resource_link下生效，示例值：销售订单明细.csv
    Description

    string

    No

    Deskripsi file.

    Type= resource_link下生效，示例值：销售订单明细.csv
    Meta

    object

    No

    Metadata prompt yang diperluas oleh DataWorks.

    Hide

    boolean

    No

    true or false
    Meta

    object

    No

    Metadata yang diperluas.

    Context

    any

    No

    Nilai bertipe Map. Dalam skenario agen kustom, Anda dapat menggunakan parameter ini untuk mengganti parameter placeholder.

    { "key1": "value1", "key2": "value2" }

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    Id permintaan

    D5D70885-7CC7-594A-80C7-2EF1B00FFB4B
    Timestamp

    integer

    Stempel waktu.

    1747447032
    Jsonrpc

    string

    Versi JSON-RPC. Nilai tetap: 2.0.

    2.0
    Id

    string

    ID yang dikirimkan oleh pemanggil. Nilai dikembalikan apa adanya dalam respons.

    631478864897630XXXX
    Result

    any

    Kumpulan hasil frame SSE. Konten respons sesuai dengan spesifikasi Agent Client Protocol (ACP) sumber terbuka. Untuk informasi selengkapnya, lihat https://agentclientprotocol.com/protocol/prompt-turn

    {"stopReason":"end_turn"}

    Error

    any

    Informasi error yang dikembalikan dalam frame SSE. Konten respons sesuai dengan spesifikasi Agent Client Protocol (ACP) sumber terbuka. Untuk informasi selengkapnya, lihat https://agentclientprotocol.com/protocol/prompt-turn

    {"code": 400, "errorCode": "0x50000000001", "message": "not exist session", "data": null}
    Method

    string

    Metode SSE. Konten respons sesuai dengan spesifikasi Agent Client Protocol (ACP) sumber terbuka. Untuk informasi selengkapnya, lihat https://agentclientprotocol.com/protocol/prompt-turn

    session/update
    Params

    any

    Parameter SSE. Konten respons sesuai dengan spesifikasi Agent Client Protocol (ACP) sumber terbuka. Untuk informasi selengkapnya, lihat https://agentclientprotocol.com/protocol/prompt-turn

    {"sessionId":"af4f5ef8-e8f5-481c-ad1f-94886c6c0aed","update":{"sessionUpdate":"agent_message_chunk","content":{"type":"text","text":"hello world"}}}

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "D5D70885-7CC7-594A-80C7-2EF1B00FFB4B",
  "Timestamp": 1747447032,
  "Jsonrpc": "2.0",
  "Id": "631478864897630XXXX",
  "Result": "{\"stopReason\":\"end_turn\"}\n",
  "Error": "{\"code\": 400, \"errorCode\": \"0x50000000001\", \"message\": \"not exist session\", \"data\": null}",
  "Method": "session/update",
  "Params": "{\"sessionId\":\"af4f5ef8-e8f5-481c-ad1f-94886c6c0aed\",\"update\":{\"sessionUpdate\":\"agent_message_chunk\",\"content\":{\"type\":\"text\",\"text\":\"hello world\"}}}"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.