All Products
Search
Document Center

Quick BI:ModifyCopilotEmbedConfig

Last Updated:Jun 11, 2026

Mengubah konfigurasi penyematan kueri cerdas.

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

quickbi-public:ModifyCopilotEmbedConfig

update

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

CopilotId

string

Yes

ID penyematan.

ccd3428c-dd2xxxxxxxxxxxxdffee

DataRange

string

No

Rentang data.

Penting Tipe parameter adalah jsonString, dan hanya satu sakelar antara tema analisis dan resource kueri yang dapat aktif. Jika sakelar pilih-semua bernilai true, sakelar tersebut akan diutamakan. Disarankan untuk hanya meneruskan satu parameter, dengan catatan lainnya
.

如果客户要授权所有分析主题,则 {allTheme: true} 如果客户要授权所有问数资源,则 {allCube: true} 如果客户要授权部分问数资源,则 {llmCubes: [12314,12345]} 如果客户要授权部分分析主题,则 {themes: [12314,12345]}

ModuleName

string

No

Nama modul.

小Q

AgentName

string

No

Nama panggilan agen.

小Q

Elemen respons

Element

Type

Description

Example

object

Schema of Response

RequestId

string

Request ID.

4BAA4694-CC27-555F-B15A-688AA9289FEE

Success

boolean

Indicates whether the request was successful. Possible values:

  • true: The request was successful

  • false: The request failed

true

Result

boolean

Returns the result of the API execution. Possible values:

  • true: Execution succeeded

  • false: Execution failed

true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4BAA4694-CC27-555F-B15A-688AA9289FEE",
  "Success": true,
  "Result": true
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 UserRoleConfig.NotContain.Function The user %s does not have permission to operate. The user %s does not have permission to operate.
400 Copilot.Modulename.Error ModuleName max length limit 20. The maximum length of a module name is 20.
400 Copilot.AgentName.Error AgentName max length limit 10. The maximum length of the robot name is limited to 10.
400 Invalid.Parameter.Error The parameter is invalid:%s. invalid parameter: ${0}.
400 CopilotEmbed.Config.NotFind Can not find copilot embed config with this copilot ID. Cannot find this embedded configuration

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.