All Products
Search

This Product

    Alibaba Cloud Model Studio:AddChunk

    Document Center

    Alibaba Cloud Model Studio:AddChunk

    Last Updated:Sep 02, 2026

    Menambahkan chunk ke basis pengetahuan pencarian dokumen (document), kueri data (table), atau tanya jawab gambar (image).

    Deskripsi operasi

    • Operasi ini menambahkan konten chunk ke basis pengetahuan tertentu bertipe pencarian dokumen (document), kueri data (table), atau tanya jawab gambar (image). Operasi terkait pada basis pengetahuan pencarian multimedia (multimedia) tidak didukung. Untuk basis pengetahuan kueri data dan tanya jawab gambar, operasi ini hanya berlaku jika sumber datanya adalah konektor spreadsheet (excel).
    • Pengguna Resource Access Management (RAM) harus terlebih dahulu memperoleh izin API untuk Studio Model (memerlukan AliyunBailianDataFullAccess, yang mencakup izin sfm:ChunkList) dan bergabung dengan ruang kerja sebelum memanggil operasi ini. Akun Alibaba Cloud dapat memanggil operasi ini secara langsung tanpa otorisasi. Gunakan Model Studio SDKModel Studio SDK terbaru untuk memanggil operasi ini.
    • Sebelum memanggil operasi ini, pastikan bahwa basis pengetahuan Anda telah dibuat dan belum dihapus (yaitu, ID basis pengetahuan IndexId valid).
    • Operasi ini bersifat idempoten.

    Pembatasan kecepatan: Operasi ini dibatasi kecepatannya jika dipanggil terlalu sering. Jangan melebihi 10 panggilan per detik. Jika dibatasi, coba lagi nanti.

    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.

    RAM authorization

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

    Sintaks permintaan 

    POST /{WorkspaceId}/chunk/create HTTP/1.1

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example

    WorkspaceId

    string

    Yes

    ID ruang kerja.

    llm-19hxxxxx7htdf9lh

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example

    PipelineId

    string

    Yes

    ID basis pengetahuan.

    79c0alxxxx

    dataId

    string

    No

    ID file.

    doc_xxx

    field

    object

    No

    Konten chunk yang akan disisipkan, diteruskan sebagai pasangan kunci-nilai. Untuk basis pengetahuan pencarian dokumen, gunakan daftar kunci tetap berikut:

    • content (String): Wajib. Konten tubuh chunk.

    • title (String): Opsional. Judul chunk.

    • image_urls (Array): Opsional. URL gambar yang disertakan dalam chunk. Maksimal 10 gambar didukung.

    Untuk basis pengetahuan kueri data dan tanya jawab gambar, kunci tidak tetap dan ditentukan oleh spreadsheet sumber data basis pengetahuan. Kunci adalah header kolom Excel, dan nilai adalah nilai kolom yang sesuai.

    { "content": "The Bailian platform supports parsing multiple document formats including PDF, Word, and PPT.", "title": "Document Parsing and Chunking", "image_urls": [ "https://example.com/images/chunk-flow.png", "https://example.com/images/parsing-result.png" ] }

    any

    No

    Informasi bidang header untuk chunk yang disisipkan. Hanya didukung untuk basis pengetahuan kueri data dan tanya jawab gambar. Header yang berpartisipasi dalam pengambilan atau pembuatan tanggapan diperlukan. Persyaratan nilai untuk setiap tipe:

    • String: Panjang maksimum 6000.

    • Time: Timestamp 13 digit (milidetik).

    • Long: Bilangan bulat. Nilai maksimum: 2147483647.

    • Double: Nilai desimal didukung.

    • image_url: Maksimal 5 gambar. Gabungkan beberapa URL menjadi satu string yang dipisahkan oleh koma.

    {"Product Name": "Wireless Bluetooth Headphones", "Publish Time": 1752624000000, "Stock Quantity": 1580, "Unit Price": 299.99, "image_url":"https://example.com/images/headphones-front.jpg,https://example.com/images/headphones-side.jpg,https://example.com/images/headphones-package.jpg" }

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    35A267BF-xxxx-54DB-8394-AA3B0742D833

    Code

    string

    Kode status error.

    Index.InvalidParameter

    Message

    string

    Paket error.

    Required parameter(%s) missing or invalid, please check the request parameters.

    Success

    boolean

    Apakah operasi berhasil.

    Valid values:

    • true :

      true.

    • false :

      false.

    true

    Data

    boolean

    Data bisnis yang dikembalikan saat permintaan berhasil.

    Valid values:

    • true :

      true.

    • false :

      false.

    true

    Status

    string

    Kode status yang dikembalikan oleh operasi.

    200

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "35A267BF-xxxx-54DB-8394-AA3B0742D833",
  "Code": "Index.InvalidParameter",
  "Message": "Required parameter(%s) missing or invalid, please check the request parameters.",
  "Success": true,
  "Data": true,
  "Status": "200"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.