Alat: create_deployment
Membuat deployment baru di aplikasi yang ditentukan.
Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP create_deployment.
| Permintaan Curl |
|---|
curl --location 'https://ces.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "create_deployment", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Skema Input
Pesan permintaan untuk AgentService.CreateDeployment.
CreateDeploymentRequest
| Representasi JSON |
|---|
{
"parent": string,
"deploymentId": string,
"deployment": {
object ( |
| Kolom | |
|---|---|
parent |
Wajib. Aplikasi induk. Format: |
deploymentId |
Opsional. ID yang akan digunakan untuk deployment, yang akan menjadi komponen akhir dari nama resource deployment. Jika tidak diberikan, ID unik akan otomatis ditetapkan untuk deployment. |
deployment |
Wajib. Penerapan yang akan dibuat. |
Deployment
| Representasi JSON |
|---|
{ "name": string, "displayName": string, "appVersion": string, "channelProfile": { object ( |
| Kolom | |
|---|---|
name |
ID. Nama resource deployment. Format: |
displayName |
Wajib. Nama tampilan deployment. |
appVersion |
Opsional. Nama resource versi aplikasi yang akan di-deploy. Format: |
channelProfile |
Wajib. Profil channel yang digunakan dalam deployment. |
createTime |
Hanya output. Stempel waktu saat deployment ini dibuat. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
updateTime |
Hanya output. Stempel waktu saat deployment ini terakhir diperbarui. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
etag |
Hanya output. ETag yang digunakan untuk memastikan objek tidak berubah selama operasi baca-ubah-tulis. Jika etag kosong, pembaruan akan menimpa perubahan serentak. |
experimentConfig |
Opsional. Konfigurasi eksperimen untuk deployment. |
whatsappCredentials |
Opsional. Hanya input. Kredensial WhatsApp sementara diperlukan saat mengonfigurasi profil saluran WhatsApp. |
instagramCredentials |
Opsional. Hanya input. Kredensial Instagram sementara diperlukan saat mengonfigurasi profil channel Instagram. |
modelSettings |
Opsional. Setelan model untuk deployment. Menggantikan setelan model yang dikonfigurasi di tingkat aplikasi/agen. Catatan: Penggantian setelan model tingkat deployment dibatasi di balik daftar yang diizinkan. Hubungi tim CXAS untuk mengaktifkan kolom ini. |
modality |
Opsional. Modalitas deployment. Catatan: Penggantian modalitas tingkat deployment hanya dapat dilakukan oleh pihak yang masuk dalam daftar yang diizinkan. Hubungi tim CXAS untuk mengaktifkan kolom ini. |
ChannelProfile
| Representasi JSON |
|---|
{ "profileId": string, "channelType": enum ( |
| Kolom | |
|---|---|
profileId |
Opsional. ID unik profil channel. |
channelType |
Opsional. Jenis profil channel. |
personaProperty |
Opsional. Properti persona profil channel. |
webWidgetConfig |
Opsional. Konfigurasi untuk widget web. |
whatsappConfig |
Opsional. Konfigurasi khusus untuk deployment WhatsApp. |
instagramConfig |
Opsional. Konfigurasi khusus untuk deployment Instagram. |
Kolom union
|
|
disableDtmf |
Opsional. Apakah akan menonaktifkan DTMF (dual-tone multi-frequency). |
Kolom union
|
|
disableBargeInControl |
Opsional. Apakah akan menonaktifkan kontrol penyela pengguna dalam percakapan. - true: Interupsi pengguna dinonaktifkan saat agen berbicara. - false: Agen mempertahankan kontrol otomatis atas kapan pengguna dapat melakukan interupsi. |
Kolom union
|
|
noiseSuppressionLevel |
Opsional. Tingkat peredam bising profil saluran. Nilai yang tersedia adalah "low", "moderate", "high", "very_high". |
PersonaProperty
| Representasi JSON |
|---|
{
"persona": enum ( |
| Kolom | |
|---|---|
persona |
Opsional. Persona channel. |
WebWidgetConfig
| Representasi JSON |
|---|
{ "modality": enum ( |
| Kolom | |
|---|---|
modality |
Opsional. Modalitas widget web. |
theme |
Opsional. Tema widget web. |
webWidgetTitle |
Opsional. Judul widget web. |
securitySettings |
Opsional. Setelan keamanan widget web. |
SecuritySettings
| Representasi JSON |
|---|
{ "enablePublicAccess": boolean, "enableOriginCheck": boolean, "allowedOrigins": [ string ], "enableRecaptcha": boolean } |
| Kolom | |
|---|---|
enablePublicAccess |
Opsional. Menunjukkan apakah akses publik ke widget web diaktifkan. Jika |
enableOriginCheck |
Opsional. Menunjukkan apakah pemeriksaan origin untuk widget web diaktifkan. Jika |
allowedOrigins[] |
Opsional. Origin yang diizinkan untuk menghosting widget web. Asal ditentukan oleh RFC 6454. Jika kosong, semua origin diizinkan. Maksimum 100 origin yang diizinkan. Contoh: "https://example.com" |
enableRecaptcha |
Opsional. Menunjukkan apakah verifikasi reCAPTCHA untuk widget web diaktifkan. |
WhatsAppConfig
| Representasi JSON |
|---|
{ "wabaId": string, "phoneNumberId": string, "phoneNumber": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| Kolom | |
|---|---|
wabaId |
Wajib. ID Akun WhatsApp Business. |
phoneNumberId |
Wajib. ID nomor telepon Meta. |
phoneNumber |
Opsional. Nomor telepon dalam format E.164. |
displayName |
Hanya output. Nama halaman bisnis Meta yang diambil. |
thumbnailUrl |
Hanya output. URL thumbnail profil bisnis Meta yang diambil. |
description |
Hanya output. Deskripsi halaman atau profil bisnis Meta. |
InstagramConfig
| Representasi JSON |
|---|
{ "instagramAccountId": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| Kolom | |
|---|---|
instagramAccountId |
Wajib. ID Akun Instagram. |
displayName |
Hanya output. Nama halaman bisnis Meta yang diambil. |
thumbnailUrl |
Hanya output. URL thumbnail profil bisnis Meta yang diambil. |
description |
Hanya output. Deskripsi halaman atau profil bisnis Meta. |
Stempel waktu
| Representasi JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Kolom | |
|---|---|
seconds |
Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z). |
nanos |
Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif. |
ExperimentConfig
| Representasi JSON |
|---|
{
"versionRelease": {
object ( |
| Kolom | |
|---|---|
versionRelease |
Opsional. Rilis versi untuk eksperimen. |
VersionRelease
| Representasi JSON |
|---|
{ "state": enum ( |
| Kolom | |
|---|---|
state |
Opsional. Status rilis versi. |
trafficAllocations[] |
Opsional. Alokasi traffic untuk rilis versi. |
TrafficAllocation
| Representasi JSON |
|---|
{ "id": string, "trafficPercentage": integer, "appVersion": string } |
| Kolom | |
|---|---|
id |
Opsional. ID alokasi traffic. String format bebas, hingga 128 karakter. |
trafficPercentage |
Opsional. Persentase traffic dari alokasi traffic. Harus antara 0 dan 100. |
appVersion |
Opsional. Versi aplikasi alokasi traffic. Format: |
WhatsAppCredentials
| Representasi JSON |
|---|
{ "authCode": string, "pin": string, "phoneNumber": string, "businessAccountId": string, "wabaId": string, "conversationProfileId": string } |
| Kolom | |
|---|---|
authCode |
Wajib. Kode autentikasi Meta yang diberikan oleh alur pendaftaran tersemat. |
pin |
Wajib. PIN 6 digit yang dibuat oleh pengguna untuk verifikasi dua langkah. |
phoneNumber |
Wajib. Nomor telepon untuk mendaftar ke WhatsApp. |
businessAccountId |
Wajib. ID Akun Bisnis yang akan digunakan untuk nomor telepon. |
wabaId |
Wajib. ID Akun WhatsApp Business. |
conversationProfileId |
Opsional. ID Profil Percakapan yang akan digunakan untuk deployment. |
InstagramCredentials
| Representasi JSON |
|---|
{ "authCode": string, "conversationProfileId": string } |
| Kolom | |
|---|---|
authCode |
Wajib. Kode autentikasi Meta yang diberikan oleh alur pendaftaran tersemat. |
conversationProfileId |
Opsional. ID Profil Percakapan yang akan digunakan untuk deployment. |
ModelSettings
| Representasi JSON |
|---|
{ "model": string, // Union field |
| Kolom | |
|---|---|
model |
Opsional. Model LLM yang harus digunakan agen. Jika tidak disetel, agen akan mewarisi model dari agen induknya. |
Kolom union
|
|
temperature |
Opsional. Jika disetel, suhu ini akan digunakan untuk model LLM. Temperatur mengontrol keacakan respons model. Temperatur yang lebih rendah menghasilkan respons yang lebih dapat diprediksi. Temperatur yang lebih tinggi menghasilkan respons yang lebih kreatif. |
ChannelType
Jenis profil channel.
| Enum | |
|---|---|
UNKNOWN |
Jenis channel tidak diketahui. |
WEB_UI |
Saluran UI Web. |
API |
Saluran API. |
TWILIO |
Saluran Twilio. |
GOOGLE_TELEPHONY_PLATFORM |
Channel Google Telephony Platform. |
CONTACT_CENTER_AS_A_SERVICE |
Saluran Contact Center as a Service (CCaaS). |
CONTACT_CENTER_AS_A_SERVICE_CHAT |
Saluran Contact Center as a Service (CCaaS Chat). |
FIVE9 |
Channel Five9. |
CONTACT_CENTER_INTEGRATION |
Saluran integrasi pusat kontak pihak ketiga. |
WHATSAPP |
Saluran WhatsApp. |
INSTAGRAM |
Saluran Instagram. |
Persona
Persona channel.
| Enum | |
|---|---|
UNKNOWN |
Persona TIDAK DIKENAL. |
CONCISE |
Agen menjaga agar respons tetap ringkas dan langsung ke intinya |
CHATTY |
Agen memberikan konteks, penjelasan, dan detail tambahan |
Modalitas
Modalitas widget web.
| Enum | |
|---|---|
MODALITY_UNSPECIFIED |
Modalitas tidak diketahui. |
CHAT_AND_VOICE |
Widget mendukung input chat dan suara. |
VOICE_ONLY |
Widget hanya mendukung input suara. |
CHAT_ONLY |
Widget hanya mendukung input chat. |
CHAT_VOICE_AND_VIDEO |
Widget mendukung input chat, suara, dan video. |
Tema
Tema widget web.
| Enum | |
|---|---|
THEME_UNSPECIFIED |
Tema tidak diketahui. |
LIGHT |
Tema terang. |
DARK |
Tema gelap. |
Negara Bagian
Status eksperimen.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Status tidak ditentukan. |
PENDING |
Tidak digunakan lagi: Status ini tidak digunakan lagi. |
RUNNING |
Status berjalan. Eksperimen sedang berjalan dan valid. |
DONE |
Tidak digunakan lagi: Status ini tidak digunakan lagi. |
EXPIRED |
Tidak digunakan lagi: Status ini tidak digunakan lagi. |
Modalitas
Modalitas deployment.
| Enum | |
|---|---|
MODALITY_UNSPECIFIED |
Modalitas tidak diketahui. |
MODALITY_TEXT |
Modalitas teks. |
MODALITY_VOICE |
Modalitas suara. |
MODALITY_VIDEO |
Modalitas video. |
Skema Output
Deployment mewakili versi aplikasi yang tidak dapat diubah dan dapat dikueri. Deployment digunakan untuk men-deploy versi aplikasi dengan profil saluran tertentu.
Deployment
| Representasi JSON |
|---|
{ "name": string, "displayName": string, "appVersion": string, "channelProfile": { object ( |
| Kolom | |
|---|---|
name |
ID. Nama resource deployment. Format: |
displayName |
Wajib. Nama tampilan deployment. |
appVersion |
Opsional. Nama resource versi aplikasi yang akan di-deploy. Format: |
channelProfile |
Wajib. Profil channel yang digunakan dalam deployment. |
createTime |
Hanya output. Stempel waktu saat deployment ini dibuat. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
updateTime |
Hanya output. Stempel waktu saat deployment ini terakhir diperbarui. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
etag |
Hanya output. ETag yang digunakan untuk memastikan objek tidak berubah selama operasi baca-ubah-tulis. Jika etag kosong, pembaruan akan menimpa perubahan serentak. |
experimentConfig |
Opsional. Konfigurasi eksperimen untuk deployment. |
whatsappCredentials |
Opsional. Hanya input. Kredensial WhatsApp sementara diperlukan saat mengonfigurasi profil saluran WhatsApp. |
instagramCredentials |
Opsional. Hanya input. Kredensial Instagram sementara diperlukan saat mengonfigurasi profil channel Instagram. |
modelSettings |
Opsional. Setelan model untuk deployment. Menggantikan setelan model yang dikonfigurasi di tingkat aplikasi/agen. Catatan: Penggantian setelan model tingkat deployment dibatasi di balik daftar yang diizinkan. Hubungi tim CXAS untuk mengaktifkan kolom ini. |
modality |
Opsional. Modalitas deployment. Catatan: Penggantian modalitas tingkat deployment hanya dapat dilakukan oleh pihak yang masuk dalam daftar yang diizinkan. Hubungi tim CXAS untuk mengaktifkan kolom ini. |
ChannelProfile
| Representasi JSON |
|---|
{ "profileId": string, "channelType": enum ( |
| Kolom | |
|---|---|
profileId |
Opsional. ID unik profil channel. |
channelType |
Opsional. Jenis profil channel. |
personaProperty |
Opsional. Properti persona profil channel. |
webWidgetConfig |
Opsional. Konfigurasi untuk widget web. |
whatsappConfig |
Opsional. Konfigurasi khusus untuk deployment WhatsApp. |
instagramConfig |
Opsional. Konfigurasi khusus untuk deployment Instagram. |
Kolom union
|
|
disableDtmf |
Opsional. Apakah akan menonaktifkan DTMF (dual-tone multi-frequency). |
Kolom union
|
|
disableBargeInControl |
Opsional. Apakah akan menonaktifkan kontrol penyela pengguna dalam percakapan. - true: Interupsi pengguna dinonaktifkan saat agen berbicara. - false: Agen mempertahankan kontrol otomatis atas kapan pengguna dapat melakukan interupsi. |
Kolom union
|
|
noiseSuppressionLevel |
Opsional. Tingkat peredam bising profil saluran. Nilai yang tersedia adalah "low", "moderate", "high", "very_high". |
PersonaProperty
| Representasi JSON |
|---|
{
"persona": enum ( |
| Kolom | |
|---|---|
persona |
Opsional. Persona channel. |
WebWidgetConfig
| Representasi JSON |
|---|
{ "modality": enum ( |
| Kolom | |
|---|---|
modality |
Opsional. Modalitas widget web. |
theme |
Opsional. Tema widget web. |
webWidgetTitle |
Opsional. Judul widget web. |
securitySettings |
Opsional. Setelan keamanan widget web. |
SecuritySettings
| Representasi JSON |
|---|
{ "enablePublicAccess": boolean, "enableOriginCheck": boolean, "allowedOrigins": [ string ], "enableRecaptcha": boolean } |
| Kolom | |
|---|---|
enablePublicAccess |
Opsional. Menunjukkan apakah akses publik ke widget web diaktifkan. Jika |
enableOriginCheck |
Opsional. Menunjukkan apakah pemeriksaan origin untuk widget web diaktifkan. Jika |
allowedOrigins[] |
Opsional. Origin yang diizinkan untuk menghosting widget web. Asal ditentukan oleh RFC 6454. Jika kosong, semua origin diizinkan. Maksimum 100 origin yang diizinkan. Contoh: "https://example.com" |
enableRecaptcha |
Opsional. Menunjukkan apakah verifikasi reCAPTCHA untuk widget web diaktifkan. |
WhatsAppConfig
| Representasi JSON |
|---|
{ "wabaId": string, "phoneNumberId": string, "phoneNumber": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| Kolom | |
|---|---|
wabaId |
Wajib. ID Akun WhatsApp Business. |
phoneNumberId |
Wajib. ID nomor telepon Meta. |
phoneNumber |
Opsional. Nomor telepon dalam format E.164. |
displayName |
Hanya output. Nama halaman bisnis Meta yang diambil. |
thumbnailUrl |
Hanya output. URL thumbnail profil bisnis Meta yang diambil. |
description |
Hanya output. Deskripsi halaman atau profil bisnis Meta. |
InstagramConfig
| Representasi JSON |
|---|
{ "instagramAccountId": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| Kolom | |
|---|---|
instagramAccountId |
Wajib. ID Akun Instagram. |
displayName |
Hanya output. Nama halaman bisnis Meta yang diambil. |
thumbnailUrl |
Hanya output. URL thumbnail profil bisnis Meta yang diambil. |
description |
Hanya output. Deskripsi halaman atau profil bisnis Meta. |
Stempel waktu
| Representasi JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Kolom | |
|---|---|
seconds |
Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z). |
nanos |
Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif. |
ExperimentConfig
| Representasi JSON |
|---|
{
"versionRelease": {
object ( |
| Kolom | |
|---|---|
versionRelease |
Opsional. Rilis versi untuk eksperimen. |
VersionRelease
| Representasi JSON |
|---|
{ "state": enum ( |
| Kolom | |
|---|---|
state |
Opsional. Status rilis versi. |
trafficAllocations[] |
Opsional. Alokasi traffic untuk rilis versi. |
TrafficAllocation
| Representasi JSON |
|---|
{ "id": string, "trafficPercentage": integer, "appVersion": string } |
| Kolom | |
|---|---|
id |
Opsional. ID alokasi traffic. String format bebas, hingga 128 karakter. |
trafficPercentage |
Opsional. Persentase traffic dari alokasi traffic. Harus antara 0 dan 100. |
appVersion |
Opsional. Versi aplikasi alokasi traffic. Format: |
WhatsAppCredentials
| Representasi JSON |
|---|
{ "authCode": string, "pin": string, "phoneNumber": string, "businessAccountId": string, "wabaId": string, "conversationProfileId": string } |
| Kolom | |
|---|---|
authCode |
Wajib. Kode autentikasi Meta yang diberikan oleh alur pendaftaran tersemat. |
pin |
Wajib. PIN 6 digit yang dibuat oleh pengguna untuk verifikasi dua langkah. |
phoneNumber |
Wajib. Nomor telepon untuk mendaftar ke WhatsApp. |
businessAccountId |
Wajib. ID Akun Bisnis yang akan digunakan untuk nomor telepon. |
wabaId |
Wajib. ID Akun WhatsApp Business. |
conversationProfileId |
Opsional. ID Profil Percakapan yang akan digunakan untuk deployment. |
InstagramCredentials
| Representasi JSON |
|---|
{ "authCode": string, "conversationProfileId": string } |
| Kolom | |
|---|---|
authCode |
Wajib. Kode autentikasi Meta yang diberikan oleh alur pendaftaran tersemat. |
conversationProfileId |
Opsional. ID Profil Percakapan yang akan digunakan untuk deployment. |
ModelSettings
| Representasi JSON |
|---|
{ "model": string, // Union field |
| Kolom | |
|---|---|
model |
Opsional. Model LLM yang harus digunakan agen. Jika tidak disetel, agen akan mewarisi model dari agen induknya. |
Kolom union
|
|
temperature |
Opsional. Jika disetel, suhu ini akan digunakan untuk model LLM. Temperatur mengontrol keacakan respons model. Temperatur yang lebih rendah menghasilkan respons yang lebih dapat diprediksi. Temperatur yang lebih tinggi menghasilkan respons yang lebih kreatif. |
ChannelType
Jenis profil channel.
| Enum | |
|---|---|
UNKNOWN |
Jenis channel tidak diketahui. |
WEB_UI |
Saluran UI Web. |
API |
Saluran API. |
TWILIO |
Saluran Twilio. |
GOOGLE_TELEPHONY_PLATFORM |
Channel Google Telephony Platform. |
CONTACT_CENTER_AS_A_SERVICE |
Saluran Contact Center as a Service (CCaaS). |
CONTACT_CENTER_AS_A_SERVICE_CHAT |
Saluran Contact Center as a Service (CCaaS Chat). |
FIVE9 |
Channel Five9. |
CONTACT_CENTER_INTEGRATION |
Saluran integrasi pusat kontak pihak ketiga. |
WHATSAPP |
Saluran WhatsApp. |
INSTAGRAM |
Saluran Instagram. |
Persona
Persona channel.
| Enum | |
|---|---|
UNKNOWN |
Persona TIDAK DIKENAL. |
CONCISE |
Agen menjaga agar respons tetap ringkas dan langsung ke intinya |
CHATTY |
Agen memberikan konteks, penjelasan, dan detail tambahan |
Modalitas
Modalitas widget web.
| Enum | |
|---|---|
MODALITY_UNSPECIFIED |
Modalitas tidak diketahui. |
CHAT_AND_VOICE |
Widget mendukung input chat dan suara. |
VOICE_ONLY |
Widget hanya mendukung input suara. |
CHAT_ONLY |
Widget hanya mendukung input chat. |
CHAT_VOICE_AND_VIDEO |
Widget mendukung input chat, suara, dan video. |
Tema
Tema widget web.
| Enum | |
|---|---|
THEME_UNSPECIFIED |
Tema tidak diketahui. |
LIGHT |
Tema terang. |
DARK |
Tema gelap. |
Negara Bagian
Status eksperimen.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Status tidak ditentukan. |
PENDING |
Tidak digunakan lagi: Status ini tidak digunakan lagi. |
RUNNING |
Status berjalan. Eksperimen sedang berjalan dan valid. |
DONE |
Tidak digunakan lagi: Status ini tidak digunakan lagi. |
EXPIRED |
Tidak digunakan lagi: Status ini tidak digunakan lagi. |
Modalitas
Modalitas deployment.
| Enum | |
|---|---|
MODALITY_UNSPECIFIED |
Modalitas tidak diketahui. |
MODALITY_TEXT |
Modalitas teks. |
MODALITY_VOICE |
Modalitas suara. |
MODALITY_VIDEO |
Modalitas video. |
Anotasi Alat
Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.
Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:
readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.destructiveHint: Jika benar (true), alat dapat melakukan tindakan merusak. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.
Petunjuk Destruktif: ✅ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌