Alibaba Cloud Model Studio:UpdateChunk

Mengubah konten dan judul chunk teks tertentu di Basis pengetahuan, serta menentukan apakah chunk tersebut berpartisipasi dalam Pengambilan Basis pengetahuan.

Deskripsi operasi

• Batasan utama: Operasi ini hanya mendukung Basis pengetahuan pencarian dokumen. Basis pengetahuan kueri data dan Tanya Jawab gambar tidak didukung.

• Persyaratan izin:

  • Pengguna RAM: Sebelum memanggil operasi ini, dapatkan izin API untuk Studio Model (Anda dapat menggunakan Kebijakan AliyunBailianDataFullAccess, yang mencakup izin sfm:UpdateChunk yang diperlukan oleh operasi ini), dan bergabung ke ruang kerja.
  • Akun Alibaba Cloud: Memiliki izin secara default dan dapat memanggil operasi ini secara langsung.

• Metode pemanggilan: Gunakan SDK Studio Model terbaru. SDK menyediakan enkapsulasi logika perhitungan tanda tangan yang kompleks dan menyederhanakan prosedur pemanggilan.

• Latensi efektif: Pembaruan biasanya berlaku segera. Selama jam sibuk, sedikit penundaan (detik) dapat terjadi.

• Idempotensi: Operasi ini bersifat idempoten. Jika Anda mengulangi operasi pada chunk teks yang telah diperbarui, operasi akan mengembalikan tanggapan berhasil.

Batas laju: Operasi ini akan dibatasi lajunya jika dipanggil terlalu sering. Jangan melebihi 10 panggilan per detik. Jika laju 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

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
sfm:UpdateChunk	update	*全部资源 *	None	None

Sintaks permintaan

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

Path Parameters

Parameter	Type	Required	Description	Example
WorkspaceId	string	Yes	ID ruang kerja Basis pengetahuan. Untuk informasi tentang cara memperoleh ID ruang kerja, lihat Cara menggunakan ruang kerja.	llm-3z7uw7fwz0vexxxx

Parameter permintaan

Parameter	Type	Required	Description	Example
PipelineId	string	Yes	ID Basis pengetahuan. Ini adalah Data.Id yang dikembalikan oleh operasi CreateIndex, atau Anda dapat memperolehnya dari halaman Basis pengetahuan.	79c0alxxxx
DataId	string	Yes	ID file. Ini adalah FileId yang dikembalikan oleh operasi AddFile. Anda juga dapat memperolehnya dari tab File di Data Aplikasi pada Konsol Studio Model dengan mengeklik ikon ID di sebelah file yang sesuai.	doc_c134aa2073204a5d936d870bf960f56axxxxxxxx
ChunkId	string	Yes	ID chunk teks yang akan diubah. Anda dapat memperoleh nilai ini dengan memanggil operasi ListChunks. Nilai tersebut berada di bidang Node.Metadata._id pada tanggapan.	llm-5ip55o1zrzxx_09fe52x_xxxxx_033b551e10024029992e79767b151fxx_10024xx_0
IsDisplayedChunkContent	boolean	Yes	Apakah chunk teks ini akan berpartisipasi dalam Pengambilan Basis pengetahuan. Nilai valid: true: Berpartisipasi. false: Tidak berpartisipasi. Nilai default: true.	true
content	string	Yes	Konten baru chunk teks. Panjang konten harus antara 10 hingga 6000 karakter dan tidak boleh melebihi panjang segmen maksimum yang ditentukan saat Basis pengetahuan dibuat.	在哲学中所获得的确定性类型不是科学的确定性(即对每个人的理智来说都一样的确定性)，而是一种要在人类的整体本质中才能获得的亲证。哲学的每一形态都不同于科学，因为所有的哲学都没有得到一致的认可...
title	string	No	Judul baru chunk teks. Panjang dibatasi hingga 0 hingga 50 karakter. String kosong diperbolehkan. Jika Anda meneruskan string kosong, judul yang ada akan dihapus. Jika Anda tidak meneruskan parameter ini, judul asli akan dipertahankan.	什么是哲学

Elemen respons

Element	Type	Description	Example
	object	Skema Tanggapan.
RequestId	string	ID permintaan.	35A267BF-xxxx-54DB-8394-AA3B0742D833
Code	string	Kode status error.
Message	string	Paket error.
Success	boolean	Apakah operasi berhasil. Nilai valid: true: Berhasil. false: Gagal.	true
Data	boolean	Data bisnis yang dikembalikan saat permintaan berhasil.	true
Status	string	Kode status yang dikembalikan oleh operasi.	"200"

Contoh

Respons sukses

JSONformat

{
  "RequestId": "35A267BF-xxxx-54DB-8394-AA3B0742D833",
  "Code": "",
  "Message": "",
  "Success": true,
  "Data": true,
  "Status": "\"200\""
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.