Alat: get_app_version
Mendapatkan detail versi aplikasi yang ditentukan.
Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_app_version.
| 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": "get_app_version", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Skema Input
Pesan permintaan untuk AgentService.GetAppVersion.
GetAppVersionRequest
| Representasi JSON |
|---|
{ "name": string } |
| Kolom | |
|---|---|
name |
Wajib. Nama resource versi aplikasi yang akan diambil. |
Skema Output
Di Customer Engagement Suite (CES), versi aplikasi adalah snapshot aplikasi pada titik waktu tertentu. ID ini tidak dapat diubah dan tidak dapat dimodifikasi setelah dibuat.
AppVersion
| Representasi JSON |
|---|
{
"name": string,
"displayName": string,
"description": string,
"creator": string,
"createTime": string,
"updateTime": string,
"snapshot": {
object ( |
| Kolom | |
|---|---|
name |
ID. ID unik versi aplikasi. Format: |
displayName |
Opsional. Nama tampilan versi aplikasi. |
description |
Opsional. Deskripsi versi aplikasi. |
creator |
Hanya output. Email pengguna yang membuat versi aplikasi. |
createTime |
Hanya output. Stempel waktu saat versi aplikasi 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 versi aplikasi 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: |
snapshot |
Hanya output. Snapshot aplikasi saat versi dibuat. |
etag |
Hanya output. Etag yang digunakan untuk memastikan objek tidak berubah selama operasi baca-ubah-tulis. Jika etag kosong, update akan menimpa perubahan serentak. |
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 nano non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif. |
AppSnapshot
| Representasi JSON |
|---|
{ "app": { object ( |
| Kolom | |
|---|---|
app |
Opsional. Setelan dasar untuk aplikasi. |
agents[] |
Opsional. Daftar agen di aplikasi. |
tools[] |
Opsional. Daftar alat di aplikasi. |
examples[] |
Opsional. Daftar contoh dalam aplikasi. |
guardrails[] |
Opsional. Daftar guardrail di aplikasi. |
toolsets[] |
Opsional. Daftar toolset di aplikasi. |
Aplikasi
| Representasi JSON |
|---|
{ "name": string, "displayName": string, "description": string, "pinned": boolean, "rootAgent": string, "languageSettings": { object ( |
| Kolom | |
|---|---|
name |
ID. ID unik aplikasi. Format: |
displayName |
Wajib. Nama tampilan aplikasi. |
description |
Opsional. Deskripsi aplikasi yang dapat dibaca manusia. |
pinned |
Opsional. Apakah aplikasi disematkan di daftar aplikasi. |
rootAgent |
Opsional. Agen root adalah titik entri aplikasi. Format: |
languageSettings |
Opsional. Setelan bahasa aplikasi. |
timeZoneSettings |
Opsional. Setelan TimeZone aplikasi. |
audioProcessingConfig |
Opsional. Konfigurasi pemrosesan audio aplikasi. |
loggingSettings |
Opsional. Setelan pencatatan log aplikasi. |
errorHandlingSettings |
Opsional. Setelan penanganan error aplikasi. |
modelSettings |
Opsional. Setelan model LLM default untuk aplikasi. Setiap resource (misalnya, agen, guardrail) dapat mengganti konfigurasi ini sesuai kebutuhan. |
toolExecutionMode |
Opsional. Mode eksekusi alat untuk aplikasi. Jika tidak diberikan, akan ditetapkan secara default ke PARALLEL. |
evaluationMetricsThresholds |
Opsional. Batas evaluasi untuk aplikasi. |
variableDeclarations[] |
Opsional. Deklarasi variabel. |
predefinedVariableDeclarations[] |
Hanya output. Deklarasi variabel yang telah ditetapkan untuk aplikasi. |
globalInstruction |
Opsional. Petunjuk untuk semua agen di aplikasi. Anda dapat menggunakan petunjuk ini untuk menyiapkan identitas atau kepribadian yang stabil di semua agen. |
guardrails[] |
Opsional. Daftar guardrail untuk aplikasi. Format: |
dataStoreSettings |
Opsional. Setelan penyimpanan data untuk aplikasi. |
defaultChannelProfile |
Opsional. Profil saluran default yang digunakan oleh aplikasi. |
metadata |
Opsional. Metadata tentang aplikasi. Kolom ini dapat digunakan untuk menyimpan informasi tambahan yang relevan dengan detail aplikasi atau penggunaan yang dimaksudkan. Objek yang berisi daftar pasangan |
createTime |
Hanya output. Stempel waktu saat aplikasi 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 aplikasi terakhir diupdate. 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, update akan menimpa perubahan serentak. |
deploymentCount |
Hanya output. Jumlah deployment di aplikasi. |
clientCertificateSettings |
Opsional. Setelan sertifikat klien default untuk aplikasi. |
vpcScSettings |
Opsional. Setelan VPC-SC untuk aplikasi. |
locked |
Opsional. Menunjukkan apakah aplikasi dikunci untuk perubahan. Jika aplikasi dikunci, perubahan pada resource aplikasi akan ditolak. |
validationErrors[] |
Hanya output. Kesalahan konfigurasi atau peringatan di aplikasi. |
dashboardSettings |
Opsional. Setelan dasbor khusus aplikasi untuk menautkan dan mengonfigurasi dasbor Contact Center Insights. |
LanguageSettings
| Representasi JSON |
|---|
{ "defaultLanguageCode": string, "supportedLanguageCodes": [ string ], "enableMultilingualSupport": boolean, "fallbackAction": string } |
| Kolom | |
|---|---|
defaultLanguageCode |
Opsional. Kode bahasa default aplikasi. |
supportedLanguageCodes[] |
Opsional. Daftar kode bahasa yang didukung oleh aplikasi, selain |
enableMultilingualSupport |
Opsional. Mengaktifkan dukungan multibahasa. Jika |
fallbackAction |
Opsional. Tidak digunakan lagi: Fitur ini tidak lagi didukung. Gunakan Tindakan ini dapat berupa tindakan standar atau panggilan alat kustom. Nilai yang valid adalah: - Nama resource lengkap alat, yang memicu eksekusi alat tertentu. - Tindakan sistem yang telah ditetapkan, seperti "eskalasi" atau "keluar", yang memicu sinyal |
TimeZoneSettings
| Representasi JSON |
|---|
{ "timeZone": string } |
| Kolom | |
|---|---|
timeZone |
Opsional. Zona waktu aplikasi dari database zona waktu, misalnya, America/Los_Angeles, Europe/Paris. |
AudioProcessingConfig
| Representasi JSON |
|---|
{ "synthesizeSpeechConfigs": { string: { object ( |
| Kolom | |
|---|---|
synthesizeSpeechConfigs |
Opsional. Konfigurasi cara respons agen harus disintesis, pemetaan dari kode bahasa ke Jika konfigurasi untuk kode bahasa yang ditentukan tidak ditemukan, konfigurasi untuk kode bahasa root akan digunakan. Misalnya, jika peta berisi "en-us" dan "en", dan kode bahasa yang ditentukan adalah "en-gb", konfigurasi "en" akan digunakan. Catatan: Kode bahasa tidak peka huruf besar/kecil. Objek yang berisi daftar pasangan |
bargeInConfig |
Opsional. Mengonfigurasi perilaku agen untuk aktivitas penyelaan pengguna. |
inactivityTimeout |
Opsional. Durasi ketidakaktifan pengguna (tidak ada ucapan atau interaksi) sebelum agen meminta pengguna untuk berinteraksi kembali. Jika tidak disetel, agen tidak akan meminta pengguna untuk berinteraksi kembali. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
ambientSoundConfig |
Opsional. Konfigurasi untuk suara sekitar yang akan diputar dengan respons agen yang disintesis, untuk meningkatkan kealamian percakapan. |
customVoiceSamples[] |
Opsional. Mengonfigurasi sampel suara kustom untuk kloning suara. |
SynthesizeSpeechConfigsEntry
| Representasi JSON |
|---|
{
"key": string,
"value": {
object ( |
| Kolom | |
|---|---|
key |
|
value |
|
SynthesizeSpeechConfig
| Representasi JSON |
|---|
{ "voice": string, "speakingRate": number, "model": string, "instruction": string } |
| Kolom | |
|---|---|
voice |
Opsional. Nama suara. Jika tidak ditetapkan, layanan akan memilih suara berdasarkan parameter lain seperti language_code. Untuk mengetahui daftar suara yang tersedia, lihat Suara dan bahasa yang didukung dari Cloud Text-to-Speech. |
speakingRate |
Opsional. Kecepatan bicara dalam rentang [0,25, 2,0]. 1,0 adalah kecepatan native normal yang didukung oleh suara tertentu. 2,0 adalah dua kali lebih cepat, dan 0,5 adalah setengahnya. Nilai di luar rentang [0,25, 2,0] akan menampilkan error. |
model |
Opsional. Model yang digunakan untuk menyintesis audio. Nilai yang saat ini didukung: - "gemini-3.1-flash-tts-preview" Jika kosong, Chirp3-HD akan digunakan. |
instruction |
Opsional. Petunjuk yang digunakan untuk menyintesis ucapan saat menggunakan model generatif. |
BargeInConfig
| Representasi JSON |
|---|
{ "disableBargeIn": boolean, "bargeInAwareness": boolean } |
| Kolom | |
|---|---|
disableBargeIn |
Opsional. Tidak digunakan lagi: Menonaktifkan interupsi pengguna saat agen berbicara. Jika true, input pengguna selama pemutaran respons agen akan diabaikan. |
bargeInAwareness |
Opsional. Jika diaktifkan, agen akan menyesuaikan respons berikutnya berdasarkan asumsi bahwa pengguna belum mendengar pesan agen sebelumnya secara lengkap. Hal ini tidak boleh digunakan dalam skenario saat respons agen ditampilkan secara visual. |
Durasi
| Representasi JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Kolom | |
|---|---|
seconds |
Detik bertanda dari rentang waktu. Harus dari -315.576.000.000 hingga +315.576.000.000 inklusif. Catatan: batas ini dihitung dari: 60 dtk/mnt * 60 mnt/jam * 24 jam/hari * 365,25 hari/tahun * 10.000 tahun |
nanos |
Pecahan detik bertanda tangan pada resolusi nanodetik dari rentang waktu. Durasi kurang dari satu detik direpresentasikan dengan kolom |
AmbientSoundConfig
| Representasi JSON |
|---|
{ "volumeGainDb": number, // Union field |
| Kolom | |
|---|---|
volumeGainDb |
Opsional. Penguatan volume (dalam dB) dari volume native normal yang didukung oleh suara bising di sekitar, dalam rentang [-96,0, 16,0]. Jika tidak disetel, atau disetel ke nilai 0,0 (dB), audio akan diputar pada amplitudo sinyal native normal. Nilai -6,0 (dB) akan diputar pada sekitar setengah amplitudo dari amplitudo sinyal native normal. Nilai +6,0 (dB) akan diputar pada amplitudo sekitar dua kali amplitudo sinyal native normal. Sebaiknya jangan melebihi +10 (dB) karena biasanya tidak ada peningkatan kenyaringan yang efektif untuk nilai yang lebih besar dari itu. |
Kolom union source. Suara bising di sekitar yang akan diputar dengan respons agen yang disintesis, untuk meningkatkan kealamian percakapan. source hanya ada berupa salah satu diantara berikut: |
|
prebuiltAmbientNoise |
Opsional. Tidak digunakan lagi: |
gcsUri |
Opsional. Suara bising di sekitar sebagai file WAV mono-channel 16 kHz yang disimpan di Cloud Storage. Catatan: Pastikan agen layanan CES |
prebuiltAmbientSound |
Opsional. Nama suara sekitar bawaan. Nilai yang valid adalah: - "coffee_shop" - "keyboard" - "keypad" - "hum" - "office_1" - "office_2" - "office_3" - "room_1" - "room_2" - "room_3" - "room_4" - "room_5" - "air_conditioner" |
CustomVoiceSample
| Representasi JSON |
|---|
{ "name": string, "voiceSampleGcsUri": string, "consentAudioGcsUri": string, "voiceInstruction": string, "previewAudioContent": string, "previewText": string, "warnings": [ { object ( |
| Kolom | |
|---|---|
name |
Opsional. Nama yang ditentukan pengguna untuk sampel suara kustom. |
voiceSampleGcsUri |
Opsional. Cloud Storage URI ke sampel audio untuk kloning suara. Sampel audio harus berupa file WAV mono-channel 24 kHz. |
consentAudioGcsUri |
Opsional. Audio izin untuk kloning suara. |
voiceInstruction |
Opsional. Petunjuk bahasa alami untuk gaya, nada, kecepatan, atau pengucapan suara. |
previewAudioContent |
Hanya output. Audio pratinjau yang disintesis untuk suara kustom, diformat sebagai WAV kanonis (LINEAR16, 24 kHz, 16-bit, mono). String berenkode base64. |
previewText |
Opsional. Teks untuk menyintesis audio pratinjau untuk suara kustom. |
warnings[] |
Hanya output. Pesan peringatan yang muncul selama pemrosesan klon suara (misalnya, level audio rendah). |
voiceInstructionMode |
Opsional. Mode petunjuk untuk sampel suara. Jika tidak ditentukan, defaultnya adalah NO_INSTRUCTION. |
Peringatan
| Representasi JSON |
|---|
{
"message": string,
"type": enum ( |
| Kolom | |
|---|---|
message |
Hanya output. Deskripsi peringatan yang dapat dibaca manusia. |
type |
Hanya output. Jenis peringatan. |
LoggingSettings
| Representasi JSON |
|---|
{ "redactionConfig": { object ( |
| Kolom | |
|---|---|
redactionConfig |
Opsional. Konfigurasi untuk cara menyamarkan data sensitif. |
audioRecordingConfig |
Opsional. Konfigurasi untuk cara perekaman interaksi audio. Audio dapat diredaksi seperti yang dikonfigurasi di |
unredactedAudioRecordingConfig |
Opsional. Mengonfigurasi rekaman tambahan audio yang tidak disamarkan. Hal ini dapat digunakan untuk mempertahankan salinan audio mentah saat penyuntingan audio |
bigqueryExportSettings |
Opsional. Mengonfigurasi perilaku BigQuery Export untuk aplikasi. Data percakapan dapat diredaksi seperti yang dikonfigurasi di |
unredactedBigqueryExportSettings |
Opsional. Mengonfigurasi perilaku BigQuery Export untuk aplikasi. Data percakapan yang tidak diredaksi akan diekspor ke Tabel BigQuery jika diaktifkan. |
cloudLoggingSettings |
Opsional. Setelan untuk mendeskripsikan perilaku Cloud Logging untuk aplikasi. |
conversationLoggingSettings |
Opsional. Setelan untuk mendeskripsikan perilaku logging percakapan untuk aplikasi. |
evaluationAudioRecordingConfig |
Opsional. Konfigurasi cara interaksi audio harus direkam untuk evaluasi. Secara default, perekaman audio tidak diaktifkan untuk sesi evaluasi. |
metricAnalysisSettings |
Opsional. Setelan untuk mendeskripsikan perilaku pengumpulan data percakapan untuk pipeline analisis LLM untuk aplikasi. |
requiredRecordingConsent |
Opsional. Apakah aplikasi harus menyatakan apa yang mungkin direkam sebelum ada yang disimpan. Jika benar (true), sesi akan dimulai dengan perekaman nonaktif dan tetap nonaktif hingga klien mengirimkan Jika |
RedactionConfig
| Representasi JSON |
|---|
{ "enableRedaction": boolean, "inspectTemplate": string, "deidentifyTemplate": string } |
| Kolom | |
|---|---|
enableRedaction |
Opsional. Jika |
inspectTemplate |
Opsional. Nama template pemeriksaan DLP untuk mengonfigurasi deteksi jenis data sensitif. Format: |
deidentifyTemplate |
Opsional. Nama template de-identifikasi DLP untuk memberikan petunjuk tentang cara melakukan de-identifikasi konten. Format: |
AudioRecordingConfig
| Representasi JSON |
|---|
{ "gcsBucket": string, "gcsPathPrefix": string } |
| Kolom | |
|---|---|
gcsBucket |
Opsional. Bucket Cloud Storage untuk menyimpan rekaman audio sesi. URI harus diawali dengan "gs://". Pilih lokasi bucket yang memenuhi persyaratan residensi data Anda. Catatan: Jika bucket Cloud Storage berada di project yang berbeda dengan aplikasi, Anda harus memberikan izin |
gcsPathPrefix |
Opsional. Awalan jalur Cloud Storage untuk rekaman audio. Awalan ini dapat menyertakan placeholder berikut, yang akan diganti secara dinamis pada waktu penayangan: - $project: project ID - $location: lokasi aplikasi - $app: ID aplikasi - $date: tanggal sesi dalam format YYYY-MM-DD - $session: ID sesi Jika awalan jalur tidak ditentukan, awalan default |
BigQueryExportSettings
| Representasi JSON |
|---|
{ "enabled": boolean, "project": string, "dataset": string } |
| Kolom | |
|---|---|
enabled |
Opsional. Menunjukkan apakah BigQuery Export diaktifkan. |
project |
Opsional. Project ID set data BigQuery tempat data akan diekspor. Catatan: Jika set data BigQuery berada di project yang berbeda dengan aplikasi, Anda harus memberikan peran |
dataset |
Opsional. ID set data BigQuery untuk mengekspor data. |
CloudLoggingSettings
| Representasi JSON |
|---|
{ "enableCloudLogging": boolean } |
| Kolom | |
|---|---|
enableCloudLogging |
Opsional. Apakah akan mengaktifkan Cloud Logging untuk sesi. |
ConversationLoggingSettings
| Representasi JSON |
|---|
{ "disableConversationLogging": boolean, "retentionWindow": string } |
| Kolom | |
|---|---|
disableConversationLogging |
Opsional. Apakah akan menonaktifkan logging percakapan untuk sesi. |
retentionWindow |
Opsional. Mengontrol periode retensi data untuk percakapan. Jika tidak ditetapkan, percakapan akan dipertahankan selama 365 hari. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
MetricAnalysisSettings
| Representasi JSON |
|---|
{ "llmMetricsOptedOut": boolean } |
| Kolom | |
|---|---|
llmMetricsOptedOut |
Opsional. Apakah akan mengumpulkan data percakapan untuk metrik analisis LLM. Jika benar, data percakapan tidak akan dikumpulkan untuk metrik analisis LLM; jika tidak, data percakapan akan dikumpulkan. |
ErrorHandlingSettings
| Representasi JSON |
|---|
{ "errorHandlingStrategy": enum ( |
| Kolom | |
|---|---|
errorHandlingStrategy |
Opsional. Strategi yang akan digunakan untuk penanganan error. |
fallbackResponseConfig |
Opsional. Konfigurasi untuk menangani respons penggantian. |
endSessionConfig |
Opsional. Konfigurasi untuk mengakhiri sesi jika terjadi error sistem (misalnya, error LLM). |
FallbackResponseConfig
| Representasi JSON |
|---|
{ "customFallbackMessages": { string: string, ... }, "maxFallbackAttempts": integer } |
| Kolom | |
|---|---|
customFallbackMessages |
Opsional. Pesan penggantian jika terjadi error sistem (misalnya, error LLM), yang dipetakan berdasarkan kode bahasa yang didukung. Objek yang berisi daftar pasangan |
maxFallbackAttempts |
Opsional. Jumlah maksimum upaya penggantian yang akan dilakukan sebelum agen memunculkan Sinyal |
CustomFallbackMessagesEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
EndSessionConfig
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union
|
|
escalateSession |
Opsional. Apakah akan mengeskalasi sesi di |
ModelSettings
| Representasi JSON |
|---|
{ "model": string, "thinkingLevel": enum ( |
| Kolom | |
|---|---|
model |
Opsional. Model LLM yang harus digunakan agen. Jika tidak ditetapkan, agen akan mewarisi model dari agen induknya. |
thinkingLevel |
Opsional. Tingkat penalaran model. |
Kolom union
|
|
temperature |
Opsional. Jika ditetapkan, suhu ini akan digunakan untuk model LLM. Suhu mengontrol keacakan respons model. Suhu yang lebih rendah menghasilkan respons yang lebih dapat diprediksi. Suhu yang lebih tinggi menghasilkan respons yang lebih kreatif. |
EvaluationMetricsThresholds
| Representasi JSON |
|---|
{ "goldenEvaluationMetricsThresholds": { object ( |
| Kolom | |
|---|---|
goldenEvaluationMetricsThresholds |
Opsional. Nilai minimum metrik evaluasi golden dataset. |
hallucinationMetricBehavior |
Opsional. Tidak digunakan lagi: Gunakan |
goldenHallucinationMetricBehavior |
Opsional. Perilaku metrik halusinasi untuk evaluasi golden dataset. |
scenarioHallucinationMetricBehavior |
Opsional. Perilaku metrik halusinasi untuk evaluasi skenario. |
GoldenEvaluationMetricsThresholds
| Representasi JSON |
|---|
{ "turnLevelMetricsThresholds": { object ( |
| Kolom | |
|---|---|
turnLevelMetricsThresholds |
Opsional. Nilai minimum metrik tingkat giliran. |
expectationLevelMetricsThresholds |
Opsional. Nilai minimum metrik tingkat ekspektasi. |
toolMatchingSettings |
Opsional. Setelan pencocokan alat. Panggilan alat tambahan adalah panggilan alat yang ada dalam eksekusi, tetapi tidak cocok dengan panggilan alat apa pun dalam ekspektasi ideal. |
TurnLevelMetricsThresholds
| Representasi JSON |
|---|
{ "semanticSimilarityChannel": enum ( |
| Kolom | |
|---|---|
semanticSimilarityChannel |
Opsional. Saluran kemiripan semantik yang akan digunakan untuk evaluasi. |
Kolom union
|
|
semanticSimilaritySuccessThreshold |
Opsional. Nilai minimum keberhasilan untuk kemiripan semantik. Harus berupa bilangan bulat antara 0 dan 4. Defaultnya adalah >= 3. |
Kolom union
|
|
overallToolInvocationCorrectnessThreshold |
Opsional. Nilai minimum keberhasilan untuk keseluruhan ketepatan pemanggilan alat. Harus berupa float antara 0 dan 1. Default-nya adalah 1.0. |
ExpectationLevelMetricsThresholds
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union
|
|
toolInvocationParameterCorrectnessThreshold |
Opsional. Nilai minimum keberhasilan untuk kebenaran parameter pemanggilan alat individual. Harus berupa float antara 0 dan 1. Default-nya adalah 1.0. |
ToolMatchingSettings
| Representasi JSON |
|---|
{
"extraToolCallBehavior": enum ( |
| Kolom | |
|---|---|
extraToolCallBehavior |
Opsional. Perilaku untuk panggilan alat tambahan. Nilai defaultnya adalah FAIL. |
VariableDeclaration
| Representasi JSON |
|---|
{
"name": string,
"description": string,
"schema": {
object ( |
| Kolom | |
|---|---|
name |
Wajib. Nama variabel. Nama harus diawali dengan huruf atau garis bawah dan hanya berisi huruf, angka, atau garis bawah. |
description |
Wajib. Deskripsi variabel. |
schema |
Wajib. Skema variabel. |
Skema
| Representasi JSON |
|---|
{ "type": enum ( |
| Kolom | |
|---|---|
type |
Wajib. Jenis data. |
properties |
Opsional. Properti Type.OBJECT. Objek yang berisi daftar pasangan |
required[] |
Opsional. Properti yang diperlukan dari Type.OBJECT. |
description |
Opsional. Deskripsi data. |
items |
Opsional. Skema elemen Type.ARRAY. |
nullable |
Opsional. Menunjukkan apakah nilai boleh null. |
uniqueItems |
Opsional. Menunjukkan bahwa item dalam array harus unik. Hanya berlaku untuk TYPE.ARRAY. |
prefixItems[] |
Opsional. Skema elemen awal Type.ARRAY. |
additionalProperties |
Opsional. Dapat berupa boolean atau objek, mengontrol keberadaan properti tambahan. |
anyOf[] |
Opsional. Nilai harus divalidasi terhadap salah satu (atau beberapa) subskema dalam daftar. |
enum[] |
Opsional. Kemungkinan nilai elemen jenis primitif dengan format enum. Contoh: 1. We can define direction as : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. Kita dapat menentukan nomor apartemen sebagai : {type:INTEGER, format:enum, enum:["101", "201", "301"]} |
default |
Opsional. Nilai default data. |
ref |
Opsional. Mengizinkan referensi tidak langsung antara node skema. Nilai harus berupa referensi yang valid ke turunan dari root Misalnya, skema berikut menentukan referensi ke node skema bernama "Pet": Nilai properti "pet" adalah referensi ke node skema bernama "Pet". Lihat detailnya di https://json-schema.org/understanding-json-schema/structuring. |
defs |
Opsional. Peta definisi untuk digunakan oleh Objek yang berisi daftar pasangan |
title |
Opsional. Judul skema. |
minItems |
Opsional. Jumlah minimum elemen untuk Type.ARRAY. |
maxItems |
Opsional. Jumlah maksimum elemen untuk Type.ARRAY. |
Kolom union
|
|
minimum |
Opsional. Nilai minimum untuk Type.INTEGER dan Type.NUMBER. |
Kolom union
|
|
maximum |
Opsional. Nilai maksimum untuk Type.INTEGER dan Type.NUMBER. |
PropertiesEntry
| Representasi JSON |
|---|
{
"key": string,
"value": {
object ( |
| Kolom | |
|---|---|
key |
|
value |
|
Nilai
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union kind. Jenis nilai. kind hanya ada berupa salah satu diantara berikut: |
|
nullValue |
Merepresentasikan |
numberValue |
Merepresentasikan angka JSON. Tidak boleh |
stringValue |
Mewakili string JSON. |
boolValue |
Merepresentasikan boolean JSON (literal |
structValue |
Mewakili objek JSON. |
listValue |
Mewakili array JSON. |
Struct
| Representasi JSON |
|---|
{ "fields": { string: value, ... } } |
| Kolom | |
|---|---|
fields |
Peta nilai yang diketik secara dinamis dan tidak diurutkan. Objek yang berisi daftar pasangan |
FieldsEntry
| Representasi JSON |
|---|
{ "key": string, "value": value } |
| Kolom | |
|---|---|
key |
|
value |
|
ListValue
| Representasi JSON |
|---|
{ "values": [ value ] } |
| Kolom | |
|---|---|
values[] |
Kolom berulang dari nilai yang diketik secara dinamis. |
DefsEntry
| Representasi JSON |
|---|
{
"key": string,
"value": {
object ( |
| Kolom | |
|---|---|
key |
|
value |
|
DataStoreSettings
| Representasi JSON |
|---|
{
"engines": [
{
object ( |
| Kolom | |
|---|---|
engines[] |
Hanya output. Mesin untuk aplikasi. |
Mesin
| Representasi JSON |
|---|
{
"name": string,
"type": enum ( |
| Kolom | |
|---|---|
name |
Hanya output. Nama resource mesin. Format: |
type |
Hanya output. Jenis mesin. |
ChannelProfile
| Representasi JSON |
|---|
{ "profileId": string, "channelType": enum ( |
| Kolom | |
|---|---|
profileId |
Opsional. ID unik profil saluran. |
channelType |
Opsional. Jenis profil saluran. |
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 penyelaan pengguna dalam percakapan. - true: Interupsi pengguna dinonaktifkan saat agen berbicara. - false: Agen mempertahankan kontrol otomatis atas kapan pengguna dapat menyela. |
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. Origin ditentukan oleh RFC 6454. Jika kosong, semua origin akan 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. |
MetadataEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
ClientCertificateSettings
| Representasi JSON |
|---|
{ "tlsCertificate": string, "privateKey": string, "passphrase": string } |
| Kolom | |
|---|---|
tlsCertificate |
Wajib. Sertifikat TLS yang dienkode dalam format PEM. String ini harus menyertakan baris header awal dan footer akhir. |
privateKey |
Wajib. Nama resource versi secret SecretManager yang menyimpan kunci pribadi yang dienkode dalam format PEM. Format: |
passphrase |
Opsional. Nama resource versi rahasia SecretManager yang menyimpan frasa sandi untuk mendekripsi kunci pribadi. Harus dibiarkan tidak disetel jika kunci pribadi tidak dienkripsi. Format: |
VpcScSettings
| Representasi JSON |
|---|
{ "allowedOrigins": [ string ] } |
| Kolom | |
|---|---|
allowedOrigins[] |
Opsional. Origin HTTP(s) yang diizinkan yang dapat dipanggil langsung oleh alat OpenAPI di Aplikasi saat Kontrol Layanan VPC diaktifkan. String ini harus sama persis dengan origin, termasuk port jika ditentukan. Misalnya, "https://example.com" atau "https://example.com:443". Daftar ini belum berlaku untuk alat Python yang mungkin melakukan panggilan HTTP langsung. |
DashboardSettings
| Representasi JSON |
|---|
{ "defaultDashboard": string } |
| Kolom | |
|---|---|
defaultDashboard |
Opsional. Nama resource dasbor Contact Center Insights default yang terkait dengan aplikasi. Ini adalah dasbor yang akan ditampilkan saat pengguna membuka tampilan Monitoring untuk aplikasi. Format: |
Agen
| Representasi JSON |
|---|
{ "name": string, "displayName": string, "description": string, "modelSettings": { object ( |
| Kolom | |
|---|---|
name |
ID. ID unik agen. Format: |
displayName |
Wajib. Nama tampilan agen. |
description |
Opsional. Deskripsi agen yang dapat dibaca manusia. |
modelSettings |
Opsional. Konfigurasi untuk model LLM. |
instruction |
Opsional. Petunjuk untuk model LLM guna memandu perilaku agen. |
tools[] |
Opsional. Daftar alat yang tersedia untuk agen. Format: |
childAgents[] |
Opsional. Daftar agen turunan di hierarki agen. Format: |
beforeAgentCallbacks[] |
Opsional. Callback yang akan dijalankan sebelum agen dipanggil. Callback yang disediakan dijalankan secara berurutan sesuai urutan yang diberikan dalam daftar. Jika callback menampilkan respons yang diganti, eksekusi akan berhenti dan callback yang tersisa akan dilewati. |
afterAgentCallbacks[] |
Opsional. Callback yang akan dieksekusi setelah agen dipanggil. Callback yang disediakan dijalankan secara berurutan sesuai urutan yang diberikan dalam daftar. Jika callback menampilkan respons yang diganti, eksekusi akan berhenti dan callback yang tersisa akan dilewati. |
beforeModelCallbacks[] |
Opsional. Callback yang akan dijalankan sebelum model dipanggil. Jika ada beberapa panggilan ke model, callback akan dijalankan beberapa kali. Callback yang disediakan dijalankan secara berurutan sesuai urutan yang diberikan dalam daftar. Jika callback menampilkan respons yang diganti, eksekusi akan berhenti dan callback yang tersisa akan dilewati. |
afterModelCallbacks[] |
Opsional. Callback yang akan dijalankan setelah model dipanggil. Jika ada beberapa panggilan ke model, callback akan dijalankan beberapa kali. Callback yang disediakan dijalankan secara berurutan sesuai urutan yang diberikan dalam daftar. Jika callback menampilkan respons yang diganti, eksekusi akan berhenti dan callback yang tersisa akan dilewati. |
beforeToolCallbacks[] |
Opsional. Callback yang akan dijalankan sebelum alat dipanggil. Jika ada beberapa pemanggilan alat, callback akan dijalankan beberapa kali. Callback yang disediakan dijalankan secara berurutan sesuai urutan yang diberikan dalam daftar. Jika callback menampilkan respons yang diganti, eksekusi akan berhenti dan callback yang tersisa akan dilewati. |
afterToolCallbacks[] |
Opsional. Callback yang akan dieksekusi setelah alat dipanggil. Jika ada beberapa pemanggilan alat, callback akan dijalankan beberapa kali. Callback yang disediakan dijalankan secara berurutan sesuai urutan yang diberikan dalam daftar. Jika callback menampilkan respons yang diganti, eksekusi akan berhenti dan callback yang tersisa akan dilewati. |
createTime |
Hanya output. Stempel waktu saat agen 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 agen 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: |
guardrails[] |
Opsional. Daftar guardrail untuk agen. Format: |
etag |
Etag yang digunakan untuk memastikan objek tidak berubah selama operasi baca-ubah-tulis. Jika etag kosong, update akan menimpa perubahan serentak. |
toolsets[] |
Opsional. Daftar toolset untuk agen. |
generatedSummary |
Hanya output. Jika agen dibuat oleh asisten LLM, kolom ini berisi ringkasan deskriptif dari pembuatan tersebut. |
transferRules[] |
Opsional. Aturan transfer agen. Jika beberapa aturan cocok, aturan pertama dalam daftar akan digunakan. |
validationErrors[] |
Hanya output. Kesalahan konfigurasi atau error pada agen yang dapat memengaruhi kualitas agen. |
Kolom union agent_type. Jenis agen. agent_type hanya ada berupa salah satu diantara berikut: |
|
llmAgent |
Opsional. Jenis agen default. |
remoteDialogflowAgent |
Opsional. Agen Dialogflow jarak jauh yang akan digunakan untuk eksekusi agen. Jika kolom ini ditetapkan, semua properti tingkat agen lainnya akan diabaikan. Catatan: Jika agen Dialogflow berada dalam project yang berbeda dengan aplikasi, Anda harus memberikan |
remoteA2aAgent |
Opsional. Agen A2A jarak jauh yang akan digunakan untuk eksekusi agen. |
RemoteDialogflowAgent
| Representasi JSON |
|---|
{ "agent": string, "flowId": string, "environmentId": string, "inputVariableMapping": { string: string, ... }, "outputVariableMapping": { string: string, ... }, "respectResponseInterruptionSettings": boolean, "languageCodeVariable": string } |
| Kolom | |
|---|---|
agent |
Wajib. Nama resource agen Dialogflow. Format: |
flowId |
Opsional. ID alur dari alur di agen Dialogflow. |
environmentId |
Opsional. ID lingkungan agen Dialogflow yang akan digunakan untuk eksekusi agen. Jika tidak ditentukan, lingkungan draf akan digunakan. |
inputVariableMapping |
Opsional. Pemetaan nama variabel aplikasi ke nama parameter sesi Dialogflow yang akan dikirim ke agen Dialogflow sebagai input. Objek yang berisi daftar pasangan |
outputVariableMapping |
Opsional. Pemetaan nama parameter sesi Dialogflow ke nama variabel aplikasi yang akan dikirim kembali ke agen CES setelah eksekusi agen Dialogflow berakhir. Objek yang berisi daftar pasangan |
respectResponseInterruptionSettings |
Opsional. Menunjukkan apakah akan mematuhi setelan interupsi tingkat pesan yang dikonfigurasi di agen Dialogflow.
|
languageCodeVariable |
Opsional. Nama variabel yang berisi kode bahasa yang akan digunakan untuk sesi Dialogflow. Jika tidak ditentukan, kode bahasa default agen Dialogflow akan digunakan. |
InputVariableMappingEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
OutputVariableMappingEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
RemoteA2aAgent
| Representasi JSON |
|---|
{
"a2aConfig": {
object ( |
| Kolom | |
|---|---|
a2aConfig |
Wajib. Konfigurasi koneksi A2A. |
RemoteA2aConfig
| Representasi JSON |
|---|
{ "apiAuthentication": { object ( |
| Kolom | |
|---|---|
apiAuthentication |
Opsional. Konfigurasi autentikasi untuk memanggil agen jarak jauh. Opsional jika referensi registry sudah menangani autentikasi. |
inputVariableMapping |
Opsional. Pemetaan nama variabel input agen jarak jauh ke nama variabel GECX. Objek yang berisi daftar pasangan |
outputVariableMapping |
Opsional. Pemetaan nama variabel output agen jarak jauh ke nama variabel GECX. Objek yang berisi daftar pasangan |
streamingEnabled |
Opsional. Apakah streaming diaktifkan untuk remote agent. |
contextId |
Opsional. Jika tidak kosong, interaksi dengan agen A2A jarak jauh akan menggunakan ID konteks ini. Kolom context_id ini dapat merujuk ke variabel sesi seperti |
Kolom union agent_spec. Spesifikasi remote agent. agent_spec hanya ada berupa salah satu diantara berikut: |
|
agentCard |
Opsional. Kartu agen lengkap yang ditentukan secara inline. |
agentRegistry |
Opsional. Referensi ke agen di Agent Registry. Format: |
AgentCard
| Representasi JSON |
|---|
{ "name": string, "description": string, "supportedInterfaces": [ { object ( |
| Kolom | |
|---|---|
name |
Wajib. Nama agen yang dapat dibaca manusia. |
description |
Wajib. Deskripsi domain tindakan/ruang solusi agen. |
supportedInterfaces[] |
Wajib. Daftar antarmuka yang didukung yang diurutkan. Entri pertama lebih disukai. |
version |
Wajib. Versi agen. |
skills[] |
Wajib. Keahlian mewakili unit kemampuan yang dapat dilakukan agen. Hal ini mungkin agak abstrak, tetapi mewakili serangkaian tindakan yang lebih terfokus dan sangat mungkin berhasil dilakukan oleh agen. |
AgentInterface
| Representasi JSON |
|---|
{ "url": string, "protocolBinding": string, "tenant": string, "protocolVersion": string } |
| Kolom | |
|---|---|
url |
Wajib. URL tempat antarmuka ini tersedia. Harus berupa URL HTTPS absolut yang valid dalam produksi. Contoh: "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a" |
protocolBinding |
Wajib. Binding protokol yang didukung di URL ini. Ini adalah string bentuk terbuka, yang dapat dengan mudah diperluas untuk binding protokol lainnya. Yang didukung secara resmi adalah |
tenant |
ID tenant yang akan digunakan dalam permintaan saat memanggil agen. |
protocolVersion |
Wajib. Versi protokol A2A yang diekspos antarmuka ini. Gunakan versi minor terbaru yang didukung per versi utama. Contoh: "0.3", "1.0" |
AgentSkill
| Representasi JSON |
|---|
{ "id": string, "name": string, "description": string, "tags": [ string ], "examples": [ string ], "inputModes": [ string ], "outputModes": [ string ] } |
| Kolom | |
|---|---|
id |
Wajib. ID unik untuk keterampilan agen. |
name |
Wajib. Nama yang dapat dibaca manusia untuk keahlian. |
description |
Wajib. Deskripsi mendetail tentang keterampilan. |
tags[] |
Wajib. Serangkaian kata kunci yang menjelaskan kemampuan keahlian. |
examples[] |
Contoh perintah atau skenario yang dapat ditangani oleh keterampilan ini. |
inputModes[] |
Kumpulan jenis media input yang didukung untuk skill ini, yang menggantikan setelan default agen. |
outputModes[] |
Kumpulan jenis media output yang didukung untuk keahlian ini, yang menggantikan setelan default agen. |
ApiAuthentication
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union auth_config. Konfigurasi autentikasi. auth_config hanya ada berupa salah satu diantara berikut: |
|
apiKeyConfig |
Opsional. Konfigurasi untuk autentikasi kunci API. |
oauthConfig |
Opsional. Konfigurasi untuk OAuth. |
serviceAgentIdTokenAuthConfig |
Opsional. Konfigurasi untuk autentikasi token ID yang dibuat dari agen layanan CES. |
serviceAccountAuthConfig |
Opsional. Konfigurasi untuk autentikasi akun layanan. |
bearerTokenConfig |
Opsional. Konfigurasi untuk autentikasi token pemilik. |
ApiKeyConfig
| Representasi JSON |
|---|
{
"keyName": string,
"apiKeySecretVersion": string,
"requestLocation": enum ( |
| Kolom | |
|---|---|
keyName |
Wajib. Nama parameter atau nama header kunci API. Misalnya, Jika permintaan API adalah "https://example.com/act?X-Api-Key= |
apiKeySecretVersion |
Wajib. Nama resource versi secret SecretManager yang menyimpan kunci API. Format: Catatan: Anda harus memberikan peran |
requestLocation |
Wajib. Lokasi kunci dalam permintaan. |
OAuthConfig
| Representasi JSON |
|---|
{
"oauthGrantType": enum ( |
| Kolom | |
|---|---|
oauthGrantType |
Wajib. Jenis pemberian izin OAuth. |
clientId |
Wajib. Client ID dari penyedia OAuth. |
clientSecretVersion |
Wajib. Nama resource versi rahasia SecretManager yang menyimpan rahasia klien. Format: Catatan: Anda harus memberikan peran |
tokenEndpoint |
Wajib. Endpoint token di penyedia OAuth yang akan ditukar dengan token akses. |
scopes[] |
Opsional. Cakupan OAuth yang akan diberikan. |
ServiceAccountAuthConfig
| Representasi JSON |
|---|
{ "serviceAccount": string, "scopes": [ string ] } |
| Kolom | |
|---|---|
serviceAccount |
Wajib. Alamat email akun layanan yang digunakan untuk autentikasi. CES menggunakan akun layanan ini untuk menukar token akses, dan token akses tersebut kemudian dikirim di header Akun layanan harus memiliki peran |
scopes[] |
Opsional. Cakupan OAuth yang akan diberikan. Jika tidak ditentukan, cakupan default |
BearerTokenConfig
| Representasi JSON |
|---|
{ "token": string } |
| Kolom | |
|---|---|
token |
Wajib. Token pemilik. Harus dalam format |
InputVariableMappingEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
OutputVariableMappingEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
Callback
| Representasi JSON |
|---|
{ "description": string, "disabled": boolean, "proactiveExecutionEnabled": boolean, // Union field |
| Kolom | |
|---|---|
description |
Opsional. Deskripsi callback yang dapat dibaca manusia. |
disabled |
Opsional. Apakah callback dinonaktifkan. Callback yang dinonaktifkan akan diabaikan oleh agen. |
proactiveExecutionEnabled |
Opsional. Jika diaktifkan, callback juga akan dieksekusi pada output model perantara. Setelan ini hanya memengaruhi callback setelah model. AKTIFKAN DENGAN HATI-HATI. Biasanya, callback setelah model hanya perlu dijalankan setelah menerima semua respons model. Mengaktifkan eksekusi proaktif dapat berdampak negatif pada biaya dan latensi eksekusi, dan hanya boleh diaktifkan dalam situasi yang jarang terjadi. |
Kolom union callback. Callback yang akan dieksekusi. callback hanya ada berupa salah satu diantara berikut: |
|
pythonCode |
Wajib. Kode python yang akan dieksekusi untuk callback. |
AgentToolset
| Representasi JSON |
|---|
{ "toolset": string, "toolIds": [ string ] } |
| Kolom | |
|---|---|
toolset |
Wajib. Nama resource toolset. Format: |
toolIds[] |
Opsional. ID alat untuk memfilter toolset. |
TransferRule
| Representasi JSON |
|---|
{ "childAgent": string, "direction": enum ( |
| Kolom | |
|---|---|
childAgent |
Wajib. Nama resource agen turunan yang menjadi target penerapan aturan. Format: |
direction |
Wajib. Arah transfer. |
Kolom union rule_type. Jenis aturan. rule_type hanya ada berupa salah satu diantara berikut: |
|
deterministicTransfer |
Opsional. Aturan yang langsung mentransfer ke agen target saat kondisi terpenuhi. |
disablePlannerTransfer |
Opsional. Aturan yang mencegah perencana mentransfer ke agen target. |
DeterministicTransfer
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union condition_type. Kondisi yang akan dievaluasi. condition_type hanya ada berupa salah satu diantara berikut: |
|
expressionCondition |
Opsional. Aturan yang mengevaluasi kondisi status sesi. Jika kondisi bernilai benar, transfer akan terjadi. |
pythonCodeCondition |
Opsional. Aturan yang menggunakan blok kode Python untuk mengevaluasi kondisi. Jika kondisi bernilai benar, transfer akan terjadi. |
ExpressionCondition
| Representasi JSON |
|---|
{ "expression": string } |
| Kolom | |
|---|---|
expression |
Wajib. Representasi string dari kondisi cloud.api.Expression. |
PythonCodeCondition
| Representasi JSON |
|---|
{ "pythonCode": string } |
| Kolom | |
|---|---|
pythonCode |
Wajib. Kode python yang akan dieksekusi. |
DisablePlannerTransfer
| Representasi JSON |
|---|
{
"expressionCondition": {
object ( |
| Kolom | |
|---|---|
expressionCondition |
Wajib. Jika kondisi bernilai benar, perencana tidak akan diizinkan untuk mentransfer ke agen target. |
Alat
| Representasi JSON |
|---|
{ "name": string, "displayName": string, "executionType": enum ( |
| Kolom | |
|---|---|
name |
ID. Nama resource alat. Format:
Alat ini bersifat dinamis dan hanya menghasilkan output; alat ini tidak dapat direferensikan secara langsung di tempat yang memerlukan alat. |
displayName |
Hanya output. Nama tampilan alat, yang diperoleh berdasarkan jenis alat. Misalnya, nama tampilan [ClientFunction][Tool.ClientFunction] berasal dari properti |
executionType |
Opsional. Jenis eksekusi alat. |
timeout |
Opsional. Waktu tunggu untuk eksekusi alat. Jika tidak ditetapkan, waktu tunggu default adalah 30 detik untuk alat Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
createTime |
Hanya output. Stempel waktu saat alat 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 alat 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 |
Etag yang digunakan untuk memastikan objek tidak berubah selama operasi baca-ubah-tulis. Jika etag kosong, update akan menimpa perubahan serentak. |
generatedSummary |
Hanya output. Jika alat dibuat oleh asisten LLM, kolom ini berisi ringkasan deskriptif dari pembuatan tersebut. |
toolFakeConfig |
Opsional. Konfigurasi untuk perilaku alat dalam mode palsu. |
readOnly |
Hanya output. Menunjukkan apakah alat bersifat hanya baca. Jika benar (true), alat tidak dapat diubah oleh pengguna. |
Kolom union tool_type. Jenis alat. tool_type hanya ada berupa salah satu diantara berikut: |
|
clientFunction |
Opsional. Fungsi klien. |
openApiTool |
Opsional. Alat API terbuka. |
googleSearchTool |
Opsional. Alat Google Penelusuran. |
connectorTool |
Opsional. Alat Integration Connector. |
dataStoreTool |
Opsional. Alat penyimpanan data. |
pythonFunction |
Opsional. Alat fungsi Python. |
mcpTool |
Opsional. Alat MCP. Alat MCP tidak dapat dibuat atau diperbarui secara langsung dan dikelola oleh toolset MCP. |
fileSearchTool |
Opsional. Alat penelusuran file. |
systemTool |
Opsional. Alat sistem. |
agentTool |
Opsional. Alat agen. |
widgetTool |
Opsional. Alat widget. |
remoteAgentTool |
Opsional. Alat remote agent. |
ClientFunction
| Representasi JSON |
|---|
{ "name": string, "description": string, "parameters": { object ( |
| Kolom | |
|---|---|
name |
Wajib. Nama fungsi. |
description |
Opsional. Deskripsi fungsi. |
parameters |
Opsional. Skema parameter fungsi. |
response |
Opsional. Skema respons fungsi. |
OpenApiTool
| Representasi JSON |
|---|
{ "openApiSchema": string, "name": string, "description": string, "apiAuthentication": { object ( |
| Kolom | |
|---|---|
openApiSchema |
Wajib. Skema OpenAPI dalam format JSON atau YAML. |
name |
Opsional. Nama alat. Jika tidak diberikan, nama alat akan diambil dari skema OpenAPI, dari |
description |
Opsional. Deskripsi alat. Jika tidak diberikan, deskripsi alat akan diambil dari skema OpenAPI, dari |
apiAuthentication |
Opsional. Informasi autentikasi yang diperlukan oleh API. |
tlsConfig |
Opsional. Konfigurasi TLS. Menyertakan sertifikat server kustom yang akan dipercaya klien. |
serviceDirectoryConfig |
Opsional. Konfigurasi Direktori Layanan. |
ignoreUnknownFields |
Opsional. Jika true, agen akan mengabaikan kolom yang tidak diketahui dalam respons API. |
url |
Opsional. URL server skema Open API. Kolom ini hanya ditetapkan di alat dalam dependensi lingkungan selama proses ekspor jika skema berisi URL server. Selama proses impor, jika URL ini ada dalam dependensi lingkungan dan skema memiliki placeholder $env_var, URL ini akan menggantikan placeholder dalam skema. |
TlsConfig
| Representasi JSON |
|---|
{
"caCerts": [
{
object ( |
| Kolom | |
|---|---|
caCerts[] |
Wajib. Menentukan daftar sertifikat CA kustom yang diizinkan untuk verifikasi HTTPS. |
CaCert
| Representasi JSON |
|---|
{ "displayName": string, "cert": string } |
| Kolom | |
|---|---|
displayName |
Wajib. Nama sertifikat CA kustom yang diizinkan. Hal ini dapat digunakan untuk membedakan sertifikat CA kustom. |
cert |
Wajib. Sertifikat CA kustom yang diizinkan (dalam format DER) untuk verifikasi HTTPS. Tindakan ini akan mengganti trust store SSL default. Jika kosong atau tidak ditentukan, CES akan menggunakan trust store default Google untuk memverifikasi sertifikat. Catatan: Pastikan sertifikat server HTTPS ditandatangani dengan "subject alt name". Misalnya, sertifikat dapat ditandatangani sendiri menggunakan perintah berikut: String berenkode base64. |
ServiceDirectoryConfig
| Representasi JSON |
|---|
{ "service": string } |
| Kolom | |
|---|---|
service |
Wajib. Nama layanan Direktori Layanan. Format: |
GoogleSearchTool
| Representasi JSON |
|---|
{
"name": string,
"description": string,
"contextUrls": [
string
],
"preferredDomains": [
string
],
"excludeDomains": [
string
],
"promptConfig": {
object ( |
| Kolom | |
|---|---|
name |
Wajib. Nama alat. |
description |
Opsional. Deskripsi tujuan alat. |
contextUrls[] |
Opsional. Konten akan diambil langsung dari URL ini untuk konteks dan grounding. Contoh: "https://example.com/path.html". Maksimum 20 URL yang diizinkan. |
preferredDomains[] |
Opsional. Menentukan domain untuk membatasi hasil penelusuran. Contoh: "example.com", "another.site". Anda hanya dapat menentukan maksimum 20 domain. |
excludeDomains[] |
Opsional. Daftar domain yang akan dikecualikan dari hasil penelusuran. Contoh: "example.com". Maksimum 2.000 domain dapat dikecualikan. |
promptConfig |
Opsional. Petunjuk perintah yang diteruskan ke perencana tentang cara hasil penelusuran harus diproses untuk teks dan suara. |
PromptConfig
| Representasi JSON |
|---|
{ "textPrompt": string, "voicePrompt": string } |
| Kolom | |
|---|---|
textPrompt |
Opsional. Menentukan perintah yang digunakan untuk petunjuk sistem saat berinteraksi dengan agen dalam percakapan chat. Jika tidak ditetapkan, perintah default akan digunakan. |
voicePrompt |
Opsional. Menentukan perintah yang digunakan untuk petunjuk sistem saat berinteraksi dengan agen dalam percakapan suara. Jika tidak ditetapkan, perintah default akan digunakan. |
ConnectorTool
| Representasi JSON |
|---|
{ "connection": string, "action": { object ( |
| Kolom | |
|---|---|
connection |
Wajib. Nama resource lengkap dari Koneksi Integration Connectors yang direferensikan. Format: |
action |
Wajib. Tindakan yang akan digunakan alat. |
authConfig |
Opsional. Mengonfigurasi cara penanganan autentikasi di Integration Connectors. Secara default, autentikasi admin diteruskan dalam permintaan API Integration Connectors. Anda dapat menggantinya dengan konfigurasi autentikasi pengguna akhir yang berbeda. Catatan: Koneksi harus mengaktifkan penggantian autentikasi untuk menentukan konfigurasi EUC di sini - jika tidak, pembuatan ConnectorTool akan gagal. Lihat https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override untuk mengetahui detailnya. |
name |
Opsional. Nama alat yang dapat digunakan oleh Agen untuk memutuskan apakah akan memanggil ConnectorTool ini. |
description |
Opsional. Deskripsi alat yang dapat digunakan oleh Agen untuk memutuskan apakah akan memanggil ConnectorTool ini. |
Tindakan
| Representasi JSON |
|---|
{ "inputFields": [ string ], "outputFields": [ string ], // Union field |
| Kolom | |
|---|---|
inputFields[] |
Opsional. Kolom entity yang akan digunakan sebagai input untuk operasi. Jika tidak ada kolom yang ditentukan, semua kolom Entity akan digunakan. |
outputFields[] |
Opsional. Kolom entity yang akan ditampilkan dari operasi. Jika tidak ada kolom yang ditentukan, semua kolom Entity akan ditampilkan. |
Kolom union action_spec. Spesifikasi untuk tindakan yang akan dikonfigurasi agar dapat digunakan oleh alat. action_spec hanya ada berupa salah satu diantara berikut: |
|
connectionActionId |
ID tindakan Koneksi yang akan digunakan alat. |
entityOperation |
Konfigurasi operasi entity yang akan digunakan alat. |
EntityOperation
| Representasi JSON |
|---|
{
"entityId": string,
"operation": enum ( |
| Kolom | |
|---|---|
entityId |
Wajib. ID entitas. |
operation |
Wajib. Operasi yang akan dilakukan pada entity. |
EndUserAuthConfig
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union auth_config. Konfigurasi autentikasi. auth_config hanya ada berupa salah satu diantara berikut: |
|
oauth2AuthCodeConfig |
Autentikasi Kode Otorisasi OAuth 2.0. |
oauth2JwtBearerConfig |
Autentikasi Pemberian Otorisasi OAuth 2.0 Profil JWT. |
Oauth2AuthCodeConfig
| Representasi JSON |
|---|
{ "oauthToken": string } |
| Kolom | |
|---|---|
oauthToken |
Wajib. Nama parameter token OAuth yang akan diteruskan. Harus dalam format |
Oauth2JwtBearerConfig
| Representasi JSON |
|---|
{ "issuer": string, "subject": string, "clientKey": string } |
| Kolom | |
|---|---|
issuer |
Wajib. Nama parameter penerbit yang akan diteruskan. Harus dalam format |
subject |
Wajib. Nama parameter subjek yang akan diteruskan. Harus dalam format |
clientKey |
Wajib. Nama parameter klien yang akan diteruskan. Harus dalam format |
DataStoreTool
| Representasi JSON |
|---|
{ "name": string, "description": string, "boostSpecs": [ { object ( |
| Kolom | |
|---|---|
name |
Wajib. Nama alat penyimpanan data. |
description |
Opsional. Deskripsi alat. |
boostSpecs[] |
Opsional. Spesifikasi penguatan untuk menguatkan dokumen tertentu. |
modalityConfigs[] |
Opsional. Konfigurasi modalitas untuk penyimpanan data. |
filterParameterBehavior |
Opsional. Perilaku parameter filter. |
Kolom union search_source. Menentukan sumber penelusuran, baik DataStore tunggal maupun Engine. search_source hanya ada berupa salah satu diantara berikut: |
|
dataStoreSource |
Opsional. Menelusuri dalam satu DataStore tertentu. |
engineSource |
Opsional. Menelusuri dalam Engine (berpotensi di beberapa Penyimpanan Data). |
DataStoreSource
| Representasi JSON |
|---|
{
"filter": string,
"dataStore": {
object ( |
| Kolom | |
|---|---|
filter |
Opsional. Spesifikasi filter untuk DataStore. Lihat: https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata |
dataStore |
Opsional. Penyimpanan data. |
DataStore
| Representasi JSON |
|---|
{ "name": string, "type": enum ( |
| Kolom | |
|---|---|
name |
Wajib. Nama resource lengkap DataStore. Format: |
type |
Hanya output. Jenis penyimpanan data. Kolom ini bersifat hanya baca dan diisi oleh server. |
documentProcessingMode |
Hanya output. Mode pemrosesan dokumen untuk koneksi penyimpanan data. Hanya ditetapkan untuk penyimpanan data PUBLIC_WEB dan UNSTRUCTURED. |
displayName |
Hanya output. Nama tampilan penyimpanan data. |
createTime |
Hanya output. Stempel waktu saat penyimpanan data 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: |
connectorConfig |
Hanya output. Konfigurasi konektor untuk koneksi penyimpanan data. |
ConnectorConfig
| Representasi JSON |
|---|
{ "collection": string, "collectionDisplayName": string, "dataSource": string } |
| Kolom | |
|---|---|
collection |
Nama resource koleksi tempat penyimpanan data berada. |
collectionDisplayName |
Nama tampilan koleksi tempat penyimpanan data berada. |
dataSource |
Nama sumber data. Contoh: |
EngineSource
| Representasi JSON |
|---|
{
"engine": string,
"dataStoreSources": [
{
object ( |
| Kolom | |
|---|---|
engine |
Wajib. Nama resource lengkap Engine. Format: |
dataStoreSources[] |
Opsional. Gunakan untuk menargetkan DataStore tertentu dalam Engine. Jika kosong, penelusuran akan berlaku untuk semua DataStore yang terkait dengan Engine. |
filter |
Opsional. Filter yang diterapkan ke penelusuran di seluruh Mesin. Tidak relevan dan tidak digunakan jika 'data_store_sources' disediakan. Lihat: https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata |
BoostSpecs
| Representasi JSON |
|---|
{
"dataStores": [
string
],
"spec": [
{
object ( |
| Kolom | |
|---|---|
dataStores[] |
Wajib. Penyimpanan Data tempat konfigurasi penguatan diterapkan. Nama resource lengkap DataStore, seperti projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}. |
spec[] |
Wajib. Daftar spesifikasi penguatan. |
BoostSpec
| Representasi JSON |
|---|
{
"conditionBoostSpecs": [
{
object ( |
| Kolom | |
|---|---|
conditionBoostSpecs[] |
Wajib. Daftar spesifikasi penguatan. |
ConditionBoostSpec
| Representasi JSON |
|---|
{
"condition": string,
"boost": number,
"boostControlSpec": {
object ( |
| Kolom | |
|---|---|
condition |
Wajib. Ekspresi yang menentukan kondisi penguatan. Sintaksisnya sama dengan sintaksis ekspresi filter. Saat ini, satu-satunya kondisi yang didukung adalah daftar kode bahasa BCP-47. Contoh: Untuk meningkatkan saran dalam bahasa en atau fr: (lang_code: ANY("en", "fr")) |
boost |
Opsional. Kekuatan penguatan, yang harus berada dalam [-1, 1]. Penguatan negatif berarti penurunan peringkat. Nilai defaultnya adalah 0,0. Menetapkan ke 1,0 akan memberikan promosi besar pada saran. Namun, hal ini tidak berarti bahwa hasil teratas akan menjadi saran yang ditingkatkan. Menyetel ke -1,0 akan memberikan penurunan peringkat yang besar pada saran. Namun, saran lain yang relevan mungkin masih ditampilkan. Jika disetel ke 0,0, berarti tidak ada penguatan yang diterapkan. Kondisi penguatan diabaikan. |
boostControlSpec |
Opsional. Spesifikasi kompleks untuk peringkat kustom berdasarkan nilai atribut yang ditentukan pelanggan. |
BoostControlSpec
| Representasi JSON |
|---|
{ "fieldName": string, "attributeType": enum ( |
| Kolom | |
|---|---|
fieldName |
Opsional. Nama kolom yang nilainya akan digunakan untuk menentukan jumlah penguatan. |
attributeType |
Opsional. Jenis atribut yang akan digunakan untuk menentukan jumlah penguatan. Nilai atribut dapat diperoleh dari nilai kolom field_name yang ditentukan. Dalam kasus numerik, hal ini mudah, yaitu attribute_value = numerical_field_value. Namun, dalam hal keaktualan, attribute_value = (time.now() - datetime_field_value). |
interpolationType |
Opsional. Jenis interpolasi yang akan diterapkan untuk menghubungkan titik kontrol yang tercantum di bawah. |
controlPoints[] |
Opsional. Titik kontrol yang digunakan untuk menentukan kurva. Fungsi monoton (ditentukan melalui interpolation_type di atas) melewati titik kontrol yang tercantum di sini. |
ControlPoint
| Representasi JSON |
|---|
{ "attributeValue": string, "boostAmount": number } |
| Kolom | |
|---|---|
attributeValue |
Opsional. Dapat berupa salah satu dari: 1. Nilai kolom numerik. 2. Spesifikasi durasi untuk keaktualan: Nilai harus diformat sebagai nilai |
boostAmount |
Opsional. Nilai antara -1 hingga 1 untuk meningkatkan skor jika attribute_value dievaluasi ke nilai yang ditentukan di atas. |
ModalityConfig
| Representasi JSON |
|---|
{ "modalityType": enum ( |
| Kolom | |
|---|---|
modalityType |
Wajib. Jenis modalitas. |
rewriterConfig |
Opsional. Konfigurasi rewriter. |
summarizationConfig |
Opsional. Konfigurasi ringkasan. |
groundingConfig |
Opsional. Konfigurasi grounding. |
snippetsConfig |
Opsional. Konfigurasi cuplikan. |
RewriterConfig
| Representasi JSON |
|---|
{
"modelSettings": {
object ( |
| Kolom | |
|---|---|
modelSettings |
Wajib. Konfigurasi untuk model LLM. |
prompt |
Opsional. Definisi perintah. Jika tidak ditetapkan, perintah default akan digunakan. |
disabled |
Opsional. Apakah penulisan ulang dinonaktifkan. |
SummarizationConfig
| Representasi JSON |
|---|
{
"modelSettings": {
object ( |
| Kolom | |
|---|---|
modelSettings |
Opsional. Konfigurasi untuk model LLM. |
prompt |
Opsional. Definisi perintah. Jika tidak ditetapkan, perintah default akan digunakan. |
disabled |
Opsional. Apakah ringkasan dinonaktifkan. |
GroundingConfig
| Representasi JSON |
|---|
{ "groundingLevel": number, "disabled": boolean } |
| Kolom | |
|---|---|
groundingLevel |
Opsional. Nilai minimum keakuratan jawaban berdasarkan sumber yang diambil. Nilai ini memiliki rentang yang dapat dikonfigurasi, yaitu [1, 5]. Level ini digunakan untuk menetapkan nilai minimum keterbanyakan rujukan jawaban, yang berarti semua respons dengan skor keterbanyakan rujukan di bawah nilai minimum akan kembali menampilkan cuplikan yang relevan saja. Misalnya, level 3 berarti skor keakuratan harus 3 atau lebih tinggi agar respons ditampilkan. |
disabled |
Opsional. Apakah grounding dinonaktifkan. |
SnippetsConfig
| Representasi JSON |
|---|
{ "enableSnippets": boolean, "maxSnippets": integer } |
| Kolom | |
|---|---|
enableSnippets |
Opsional. Apakah cuplikan diaktifkan atau tidak. |
maxSnippets |
Opsional. Jumlah cuplikan yang akan ditampilkan per kueri. Jika tidak disetel, semua cuplikan dari layanan akan ditampilkan secara default. |
PythonFunction
| Representasi JSON |
|---|
{
"name": string,
"pythonCode": string,
"description": string,
"serviceDirectoryConfig": {
object ( |
| Kolom | |
|---|---|
name |
Opsional. Nama fungsi Python yang akan dieksekusi. Harus cocok dengan nama fungsi Python yang ditentukan dalam kode Python. Peka huruf besar/kecil. Jika nama tidak diberikan, fungsi pertama yang ditentukan dalam kode Python akan digunakan. |
pythonCode |
Opsional. Kode Python yang akan dieksekusi untuk alat. |
description |
Hanya output. Deskripsi fungsi Python, yang diuraikan dari docstring kode Python. |
serviceDirectoryConfig |
Opsional. Konfigurasi Direktori Layanan untuk alat ini. |
McpTool
| Representasi JSON |
|---|
{ "name": string, "nameOverride": string, "description": string, "inputSchema": { object ( |
| Kolom | |
|---|---|
name |
Wajib. Nama alat MCP. |
nameOverride |
Opsional. Penggantian nama alat MCP. Ini diisi jika nama diganti oleh penggantian Toolset. |
description |
Opsional. Deskripsi alat MCP. |
inputSchema |
Opsional. Skema argumen input alat MCP. |
outputSchema |
Opsional. Skema argumen output alat MCP. |
serverAddress |
Wajib. Alamat server MCP, misalnya, "https://example.com/mcp/". Jika server dibuat dengan MCP SDK, URL harus diakhiri dengan "/mcp/". Hanya server berbasis transport Streamable HTTP yang didukung. Ini sama dengan server_address di McpToolset. Lihat https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http untuk mengetahui detail selengkapnya. |
apiAuthentication |
Opsional. Informasi autentikasi yang diperlukan untuk menjalankan alat di server MCP. Untuk autentikasi token pemilik, token hanya berlaku untuk eksekusi alat, bukan untuk mencantumkan alat. Hal ini mengharuskan alat dapat dicantumkan tanpa autentikasi. |
tlsConfig |
Opsional. Konfigurasi TLS. Menyertakan sertifikat server kustom yang harus dipercaya oleh klien. |
serviceDirectoryConfig |
Opsional. Konfigurasi Direktori Layanan untuk VPC-SC, yang digunakan untuk me-resolve nama layanan dalam perimeter. |
customHeaders |
Opsional. Header kustom yang akan dikirim dalam permintaan ke server MCP. Nilai harus dalam format Objek yang berisi daftar pasangan |
state |
Hanya output. Status ketersediaan dinamis alat di server eksternal. |
CustomHeadersEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
FileSearchTool
| Representasi JSON |
|---|
{
"corpusType": enum ( |
| Kolom | |
|---|---|
corpusType |
Opsional. Jenis korpus. Default-nya adalah FULLY_MANAGED. |
name |
Wajib. Nama alat. |
description |
Opsional. Deskripsi alat. |
fileCorpus |
Opsional. Korpus tempat file disimpan. Format: projects/{project}/locations/{location}/ragCorpora/{rag_corpus} |
SystemTool
| Representasi JSON |
|---|
{ "name": string, "description": string } |
| Kolom | |
|---|---|
name |
Wajib. Nama alat sistem. |
description |
Hanya output. Deskripsi alat sistem. |
AgentTool
| Representasi JSON |
|---|
{ "name": string, "description": string, "agent": string } |
| Kolom | |
|---|---|
name |
Wajib. Nama alat agen. |
description |
Opsional. Deskripsi tujuan alat. |
agent |
Opsional. Nama resource agen yang merupakan titik entri alat. Format: |
WidgetTool
| Representasi JSON |
|---|
{ "name": string, "description": string, "widgetType": enum ( |
| Kolom | |
|---|---|
name |
Wajib. Nama tampilan alat widget. |
description |
Opsional. Deskripsi alat widget. |
widgetType |
Opsional. Jenis alat widget. Jika tidak ditentukan, jenis defaultnya adalah CUSTOMIZED. |
uiConfig |
Opsional. Konfigurasi untuk merender widget. |
dataMapping |
Opsional. Pemetaan yang menentukan cara data dari alat sumber dipetakan ke parameter input widget. |
textResponseConfig |
Opsional. Konfigurasi untuk respons teks yang selalu disertakan. |
Kolom union input. Input alat widget. input hanya ada berupa salah satu diantara berikut: |
|
parameters |
Opsional. Parameter input alat widget. |
DataMapping
| Representasi JSON |
|---|
{ "sourceToolName": string, "fieldMappings": { string: string, ... }, "pythonFunction": { object ( |
| Kolom | |
|---|---|
sourceToolName |
Opsional. Nama resource alat yang menyediakan data untuk widget (misalnya, alat penelusuran atau fungsi kustom). Format: |
fieldMappings |
Opsional. Peta kolom parameter input widget ke kolom output yang sesuai dari alat sumber. Objek yang berisi daftar pasangan |
pythonFunction |
Opsional. Konfigurasi untuk fungsi Python yang digunakan untuk mengubah output alat sumber menjadi format input widget. |
mode |
Opsional. Mode pemetaan data. |
pythonScript |
Tidak digunakan lagi: Gunakan |
FieldMappingsEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
TextResponseConfig
| Representasi JSON |
|---|
{
"type": enum ( |
| Kolom | |
|---|---|
type |
Opsional. Strategi untuk memberikan respons teks. |
staticText |
Opsional. Respons teks statis yang akan ditampilkan saat jenisnya adalah STATIC. |
textResponseInstruction |
Opsional. Petunjuk untuk LLM tentang cara membuat respons teks. Digunakan sebagai deskripsi untuk parameter respons teks jika jenisnya adalah LLM_GENERATED. |
RemoteAgentTool
| Representasi JSON |
|---|
{ "name": string, "description": string, "agentCard": { object ( |
| Kolom | |
|---|---|
name |
Wajib. Nama alat. |
description |
Wajib. Deskripsi alat. |
agentCard |
Wajib. Kartu agen dari agen jarak jauh yang dipanggil oleh alat ini. |
apiAuthentication |
Opsional. Konfigurasi autentikasi untuk memanggil agen jarak jauh. |
statefulAgent |
Opsional. Jika diaktifkan, interaksi antara aplikasi CXAS dan agen jarak jauh akan memiliki konteks yang sama. Jika agen jarak jauh menampilkan context_id, ID tersebut akan dipertahankan selama keseluruhan sesi untuk alat agen jarak jauh ini. |
inputVariableMapping |
Opsional. Pemetaan nama variabel input agen jarak jauh ke nama variabel GECX. Objek yang berisi daftar pasangan |
outputVariableMapping |
Opsional. Pemetaan nama variabel output agen jarak jauh ke nama variabel GECX. Objek yang berisi daftar pasangan |
InputVariableMappingEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
OutputVariableMappingEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
ToolFakeConfig
| Representasi JSON |
|---|
{ "enableFakeMode": boolean, // Union field |
| Kolom | |
|---|---|
enableFakeMode |
Opsional. Apakah alat menggunakan mode palsu. |
Kolom union tool_response. Responsnya bersifat statis atau disediakan oleh fungsi Python. tool_response hanya ada berupa salah satu diantara berikut: |
|
codeBlock |
Opsional. Blok kode yang akan dieksekusi, bukan panggilan alat yang sebenarnya. |
CodeBlock
| Representasi JSON |
|---|
{ "pythonCode": string } |
| Kolom | |
|---|---|
pythonCode |
Wajib. Kode Python yang akan dipanggil dalam mode palsu alat. Signature fungsi Python yang diharapkan - Untuk menangkap semua panggilan alat: def fake_tool_call(tool: Tool, input: dict[str, Any], callback_context: CallbackContext) -> Optional[dict[str, Any]]: Untuk menangkap panggilan alat tertentu: def fake_{tool_id}(tool: Tool, input: dict[str, Any], callback_context: CallbackContext) -> Optional[dict[str, Any]]: Jika fungsi menampilkan None, alat yang sebenarnya akan dipanggil. |
Contoh
| Representasi JSON |
|---|
{
"name": string,
"displayName": string,
"description": string,
"entryAgent": string,
"messages": [
{
object ( |
| Kolom | |
|---|---|
name |
ID. ID unik contoh. Format: |
displayName |
Wajib. Nama tampilan contoh. |
description |
Opsional. Deskripsi contoh yang dapat dibaca manusia. |
entryAgent |
Opsional. Agen yang awalnya menangani percakapan. Jika tidak ditentukan, contoh ini mewakili percakapan yang ditangani oleh agen root. Format: |
messages[] |
Opsional. Kumpulan pesan yang membentuk percakapan. |
createTime |
Hanya output. Stempel waktu saat contoh 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 contoh 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: |
invalid |
Hanya output. Contoh ini dapat menjadi tidak valid jika resource yang direferensikan dihapus. Contoh yang tidak valid tidak akan digunakan sebagai contoh few-shot. |
etag |
Etag yang digunakan untuk memastikan objek tidak berubah selama operasi baca-ubah-tulis. Jika etag kosong, update akan menimpa perubahan serentak. |
Pesan
| Representasi JSON |
|---|
{
"role": string,
"chunks": [
{
object ( |
| Kolom | |
|---|---|
role |
Opsional. Peran dalam percakapan, misalnya, pengguna, agen. |
chunks[] |
Opsional. Konten pesan sebagai serangkaian potongan. |
eventTime |
Opsional. Stempel waktu saat pesan dikirim atau diterima. Tidak boleh digunakan jika pesan adalah bagian dari Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
Bagian
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union data. Membagi data menjadi beberapa bagian. data hanya ada berupa salah satu diantara berikut: |
|
text |
Opsional. Data teks. |
transcript |
Opsional. Transkrip yang terkait dengan audio. |
blob |
Opsional. Data blob. |
payload |
Opsional. Data payload kustom. |
image |
Opsional. Data gambar. |
toolCall |
Opsional. Permintaan eksekusi alat. |
toolResponse |
Opsional. Respons eksekusi alat. |
agentTransfer |
Opsional. Peristiwa transfer agen. |
updatedVariables |
Struct mewakili variabel yang diperbarui dalam percakapan, yang diberi kunci berdasarkan nama variabel. |
defaultVariables |
Struct mewakili variabel default di awal percakapan, yang diberi kunci berdasarkan nama variabel. |
Blob
| Representasi JSON |
|---|
{ "mimeType": string, "data": string } |
| Kolom | |
|---|---|
mimeType |
Wajib. Jenis MIME standar IANA dari data sumber. |
data |
Wajib. Byte mentah blob. String berenkode base64. |
Gambar
| Representasi JSON |
|---|
{ "mimeType": string, "data": string, "altText": string } |
| Kolom | |
|---|---|
mimeType |
Wajib. Jenis MIME standar IANA dari data sumber. Jenis gambar yang didukung meliputi: * image/png * image/jpeg * image/webp |
data |
Wajib. Byte mentah gambar. String berenkode base64. |
altText |
Opsional. Teks alternatif untuk gambar. |
ToolCall
| Representasi JSON |
|---|
{ "id": string, "displayName": string, "args": { object }, "parentToolCallId": string, "agentName": string, "targetApp": string, // Union field |
| Kolom | |
|---|---|
id |
Opsional. ID unik panggilan alat. Jika diisi, klien harus menampilkan hasil eksekusi dengan ID yang cocok di |
displayName |
Hanya output. Nama tampilan alat. |
args |
Opsional. Parameter dan nilai input untuk alat dalam format objek JSON. |
parentToolCallId |
Hanya output. ID panggilan alat yang menyebabkan panggilan ini, saat dikeluarkan oleh sub-agen yang bekerja atas nama panggilan induk. Kosong untuk panggilan tingkat teratas. Memungkinkan klien mengelompokkan pekerjaan sub-agen di bawah panggilan yang memulainya, bukan merender setiap langkah sebagai sibling. |
agentName |
Hanya output. Nama agen yang dapat dibaca manusia yang mengeluarkan panggilan ini, misalnya "Contract Architect". Kosong saat agen root mengeluarkannya. |
targetApp |
Hanya output. Aplikasi yang ditargetkan oleh panggilan ini, yang diperoleh asisten dari argumen resource panggilan: nama resource aplikasi, |
Kolom union tool_identifier. ID alat yang akan dieksekusi. Alat ini dapat berupa alat yang dipertahankan atau alat dari toolset. tool_identifier hanya ada berupa salah satu diantara berikut: |
|
tool |
Opsional. Nama alat yang akan dieksekusi. Format: |
toolsetTool |
Opsional. Alat toolset yang akan dijalankan. |
ToolsetTool
| Representasi JSON |
|---|
{ "toolset": string, "toolId": string } |
| Kolom | |
|---|---|
toolset |
Wajib. Nama resource Toolset yang menjadi asal alat ini. Format: |
toolId |
Opsional. ID alat untuk memfilter alat yang akan diambil skemanya. |
ToolResponse
| Representasi JSON |
|---|
{ "id": string, "displayName": string, "response": { object }, "parentToolCallId": string, "agentName": string, "targetApp": string, // Union field |
| Kolom | |
|---|---|
id |
Opsional. ID kecocokan |
displayName |
Hanya output. Nama tampilan alat. |
response |
Wajib. Hasil eksekusi alat dalam format objek JSON. Gunakan kunci "output" untuk menentukan respons alat dan kunci "error" untuk menentukan detail error (jika ada). Jika kunci "output" dan "error" tidak ditentukan, seluruh "respons" akan diperlakukan sebagai hasil eksekusi alat. |
parentToolCallId |
Hanya output. ID panggilan alat yang menyebabkan panggilan ini, saat dikeluarkan oleh sub-agen yang bekerja atas nama panggilan induk. Kosong untuk panggilan tingkat teratas. Memungkinkan klien mengelompokkan pekerjaan sub-agen di bawah panggilan yang memulainya, bukan merender setiap langkah sebagai sibling. |
agentName |
Hanya output. Nama agen yang dapat dibaca manusia yang mengeluarkan panggilan ini, misalnya "Contract Architect". Kosong saat agen root mengeluarkannya. |
targetApp |
Hanya output. Aplikasi yang ditargetkan oleh alat yang dieksekusi; mencerminkan |
Kolom union tool_identifier. ID alat yang dieksekusi. Alat ini dapat berupa alat yang dipertahankan atau alat dari toolset. tool_identifier hanya ada berupa salah satu diantara berikut: |
|
tool |
Opsional. Nama alat yang akan dieksekusi. Format: |
toolsetTool |
Opsional. Alat toolset yang dijalankan. |
AgentTransfer
| Representasi JSON |
|---|
{ "targetAgent": string, "displayName": string } |
| Kolom | |
|---|---|
targetAgent |
Wajib. Agen yang akan menerima transfer percakapan. Agen akan menangani percakapan mulai dari titik ini. Format: |
displayName |
Hanya output. Nama tampilan agen. |
Guardrail
| Representasi JSON |
|---|
{ "name": string, "displayName": string, "description": string, "enabled": boolean, "action": { object ( |
| Kolom | |
|---|---|
name |
ID. ID unik guardrail. Format: |
displayName |
Wajib. Nama tampilan guardrail. |
description |
Opsional. Deskripsi guardrail. |
enabled |
Opsional. Apakah guardrail diaktifkan. |
action |
Opsional. Tindakan yang harus dilakukan saat guardrail dipicu. |
createTime |
Hanya output. Stempel waktu saat guardrail 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 guardrail 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 |
Etag yang digunakan untuk memastikan objek tidak berubah selama operasi baca-ubah-tulis. Jika etag kosong, update akan menimpa perubahan serentak. |
Kolom union guardrail_type. Jenis guardrail. guardrail_type hanya ada berupa salah satu diantara berikut: |
|
contentFilter |
Opsional. Guardrail yang melarang penggunaan konten tertentu dalam percakapan. |
llmPromptSecurity |
Opsional. Guardrail yang memblokir percakapan jika perintah dianggap tidak aman berdasarkan klasifikasi LLM. |
llmPolicy |
Opsional. Guardrail yang memblokir percakapan jika respons LLM dianggap melanggar kebijakan berdasarkan klasifikasi LLM. |
modelSafety |
Opsional. Guardrail yang memblokir percakapan jika respons LLM dianggap tidak aman berdasarkan setelan keamanan model. |
codeCallback |
Opsional. Guardrail yang berpotensi memblokir percakapan berdasarkan hasil eksekusi callback. |
supervisor |
Opsional. Pedoman yang menjalankan intervensi supervisor. |
ContentFilter
| Representasi JSON |
|---|
{
"bannedContents": [
string
],
"bannedContentsInUserInput": [
string
],
"bannedContentsInAgentResponse": [
string
],
"matchType": enum ( |
| Kolom | |
|---|---|
bannedContents[] |
Opsional. Daftar frasa yang dilarang. Berlaku untuk input pengguna dan respons agen. |
bannedContentsInUserInput[] |
Opsional. Daftar frasa yang dilarang. Hanya berlaku untuk input pengguna. |
bannedContentsInAgentResponse[] |
Opsional. Daftar frasa yang dilarang. Hanya berlaku untuk respons agen. |
matchType |
Wajib. Jenis pencocokan untuk filter konten. |
disregardDiacritics |
Opsional. Jika true, diakritik akan diabaikan selama pencocokan. |
sensitiveWordsExemptions[] |
Opsional. Entri daftar kata sensitif yang diizinkan oleh guardrail ini. Hanya valid jika match_type adalah SENSITIVE_WORDS. Setiap nilai harus sama dengan entri daftar (tidak peka huruf besar/kecil, spasi kosong di sekitarnya diabaikan); nilai lainnya tidak berpengaruh. Hanya berlaku untuk guardrail ini. Maksimum 1.000 entri dengan panjang masing-masing hingga 256 karakter. |
LlmPromptSecurity
| Representasi JSON |
|---|
{ "failOpen": boolean, // Union field |
| Kolom | |
|---|---|
failOpen |
Opsional. Menentukan perilaku saat guardrail mengalami error LLM. - Jika true: guardrail akan diabaikan. - Jika salah (default): guardrail akan dipicu/diblokir. Catatan: Jika kebijakan kustom disediakan, kolom ini akan diabaikan dan digantikan oleh konfigurasi 'fail_open' kebijakan. |
Kolom union security_config. Menentukan mode konfigurasi keamanan. Pengguna harus memilih salah satu konfigurasi berikut. security_config hanya ada berupa salah satu diantara berikut: |
|
defaultSettings |
Opsional. Menggunakan setelan keamanan default yang telah ditentukan sistem. Untuk memilih mode ini, sertakan pesan 'default_settings' kosong dalam permintaan. Kolom 'default_prompt_template' di dalamnya akan diisi oleh server dalam respons. |
customPolicy |
Opsional. Gunakan LlmPolicy yang ditentukan pengguna untuk mengonfigurasi guardrail keamanan. |
DefaultSecuritySettings
| Representasi JSON |
|---|
{ "defaultPromptTemplate": string } |
| Kolom | |
|---|---|
defaultPromptTemplate |
Hanya output. Template perintah default yang digunakan oleh sistem. Kolom ini ditujukan untuk tujuan tampilan guna menunjukkan kepada pengguna perintah yang digunakan sistem secara default. Nilainya adalah OUTPUT_ONLY. |
LlmPolicy
| Representasi JSON |
|---|
{ "maxConversationMessages": integer, "modelSettings": { object ( |
| Kolom | |
|---|---|
maxConversationMessages |
Opsional. Saat memeriksa kebijakan ini, pertimbangkan 'n' pesan terakhir dalam percakapan. Jika tidak ditetapkan, nilai default 10 akan digunakan. |
modelSettings |
Opsional. Setelan model. |
prompt |
Wajib. Perintah kebijakan. Mendukung placeholder variabel sesi ( |
policyScope |
Wajib. Menentukan kapan harus menerapkan pemeriksaan kebijakan selama percakapan. Jika disetel ke |
failOpen |
Opsional. Jika terjadi error selama pemeriksaan kebijakan, fail open dan jangan picu guardrail. |
allowShortUtterance |
Opsional. Secara default, pemeriksaan kebijakan LLM dilewati untuk ucapan singkat. Jika setelan ini diaktifkan, pemeriksaan kebijakan akan diterapkan ke semua ucapan, termasuk ucapan yang biasanya dilewati. |
ModelSafety
| Representasi JSON |
|---|
{
"safetySettings": [
{
object ( |
| Kolom | |
|---|---|
safetySettings[] |
Wajib. Daftar setelan keamanan. |
SafetySetting
| Representasi JSON |
|---|
{ "category": enum ( |
| Kolom | |
|---|---|
category |
Wajib. Kategori bahaya. |
threshold |
Wajib. Batas blokir bahaya. |
CodeCallback
| Representasi JSON |
|---|
{ "beforeAgentCallback": { object ( |
| Kolom | |
|---|---|
beforeAgentCallback |
Opsional. Callback yang akan dijalankan sebelum agen dipanggil. Setiap fungsi callback diharapkan menampilkan struktur (misalnya, dict atau objek) yang berisi setidaknya: - 'decision': 'OK' atau 'TRIGGER'. - 'reason': String yang menjelaskan keputusan. Keputusan 'TRIGGER' dapat menghentikan pemrosesan lebih lanjut. |
afterAgentCallback |
Opsional. Callback yang akan dieksekusi setelah agen dipanggil. Setiap fungsi callback diharapkan menampilkan struktur (misalnya, dict atau objek) yang berisi setidaknya: - 'decision': 'OK' atau 'TRIGGER'. - 'reason': String yang menjelaskan keputusan. Keputusan 'TRIGGER' dapat menghentikan pemrosesan lebih lanjut. |
beforeModelCallback |
Opsional. Callback yang akan dijalankan sebelum model dipanggil. Jika ada beberapa panggilan ke model, callback akan dijalankan beberapa kali. Setiap fungsi callback diharapkan menampilkan struktur (misalnya, dict atau objek) yang berisi setidaknya: - 'decision': 'OK' atau 'TRIGGER'. - 'reason': String yang menjelaskan keputusan. Keputusan 'TRIGGER' dapat menghentikan pemrosesan lebih lanjut. |
afterModelCallback |
Opsional. Callback yang akan dieksekusi setelah model dipanggil. Jika ada beberapa panggilan ke model, callback akan dijalankan beberapa kali. Setiap fungsi callback diharapkan menampilkan struktur (misalnya, dict atau objek) yang berisi setidaknya: - 'decision': 'OK' atau 'TRIGGER'. - 'reason': String yang menjelaskan keputusan. Keputusan 'TRIGGER' dapat menghentikan pemrosesan lebih lanjut. |
Supervisor
| Representasi JSON |
|---|
{ "type": enum ( |
| Kolom | |
|---|---|
type |
Opsional. Jenis supervisor. |
detectionMode |
Opsional. Mode deteksi supervisor. |
TriggerAction
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union action. Tindakan yang harus diambil. action hanya ada berupa salah satu diantara berikut: |
|
respondImmediately |
Opsional. Segera merespons dengan respons yang telah dikonfigurasi sebelumnya. |
transferAgent |
Opsional. Mentransfer percakapan ke agen lain. |
generativeAnswer |
Opsional. Merespons dengan jawaban generatif. |
RespondImmediately
| Representasi JSON |
|---|
{
"responses": [
{
object ( |
| Kolom | |
|---|---|
responses[] |
Wajib. Template pesan yang dapat dipilih agen. Respons dipilih secara acak. |
Respons
| Representasi JSON |
|---|
{ "text": string, "disabled": boolean } |
| Kolom | |
|---|---|
text |
Wajib. Teks yang akan digunakan agen untuk merespons. |
disabled |
Opsional. Apakah respons dinonaktifkan. Respons yang dinonaktifkan tidak digunakan oleh agen. |
TransferAgent
| Representasi JSON |
|---|
{ "agent": string } |
| Kolom | |
|---|---|
agent |
Wajib. Nama agen yang akan menerima transfer percakapan. Agen harus berada di aplikasi yang sama dengan agen saat ini. Format: |
GenerativeAnswer
| Representasi JSON |
|---|
{ "prompt": string } |
| Kolom | |
|---|---|
prompt |
Wajib. Perintah yang akan digunakan untuk jawaban generatif. |
Toolset
| Representasi JSON |
|---|
{ "name": string, "displayName": string, "description": string, "timeout": string, "createTime": string, "updateTime": string, "etag": string, "executionType": enum ( |
| Kolom | |
|---|---|
name |
ID. ID unik toolset. Format: |
displayName |
Opsional. Nama tampilan toolset. Harus unik dalam aplikasi yang sama. |
description |
Opsional. Deskripsi toolset. |
timeout |
Opsional. Waktu tunggu untuk eksekusi toolset. Jika tidak ditetapkan, waktu tunggu default adalah 30 detik untuk toolset Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
createTime |
Hanya output. Stempel waktu saat set alat 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 toolset 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 |
ETag yang digunakan untuk memastikan objek tidak berubah selama operasi read-modify-write. Jika etag kosong, update akan menimpa perubahan serentak. |
executionType |
Opsional. Jenis eksekusi alat dalam toolset. |
toolFakeConfig |
Opsional. Konfigurasi untuk perilaku alat dalam mode palsu. |
Kolom union toolset_type. Jenis toolset. toolset_type hanya ada berupa salah satu diantara berikut: |
|
mcpToolset |
Opsional. Toolset yang berisi daftar alat yang ditawarkan oleh server MCP. |
openApiToolset |
Opsional. Toolset yang berisi daftar alat yang ditentukan oleh skema OpenAPI. |
connectorToolset |
Opsional. Toolset yang menghasilkan alat dari Koneksi Integration Connectors. |
McpToolset
| Representasi JSON |
|---|
{ "serverAddress": string, "apiAuthentication": { object ( |
| Kolom | |
|---|---|
serverAddress |
Wajib. Alamat server MCP, misalnya, "https://example.com/mcp/". Jika server dibuat dengan MCP SDK, URL harus diakhiri dengan "/mcp/". Hanya server berbasis transport Streamable HTTP yang didukung. Lihat https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http untuk mengetahui detail selengkapnya. |
apiAuthentication |
Opsional. Informasi autentikasi yang diperlukan untuk mengakses alat dan menjalankan alat di server MCP. Untuk autentikasi token pemilik, token hanya berlaku untuk eksekusi alat, bukan untuk mencantumkan alat. Hal ini mengharuskan alat dapat dicantumkan tanpa autentikasi. |
serviceDirectoryConfig |
Opsional. Konfigurasi Direktori Layanan untuk VPC-SC, yang digunakan untuk me-resolve nama layanan dalam perimeter. |
tlsConfig |
Opsional. Konfigurasi TLS. Menyertakan sertifikat server kustom yang harus dipercaya oleh klien. |
customHeaders |
Opsional. Header kustom yang akan dikirim dalam permintaan ke server MCP. Nilai harus dalam format Objek yang berisi daftar pasangan |
toolOverrides[] |
Opsional. Penggantian untuk setiap alat dalam set alat ini. Hal ini memungkinkan penggantian detail tertentu seperti deskripsi, nama, atau penyematan status alat sehingga tidak sepenuhnya dinamis. |
CustomHeadersEntry
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key |
|
value |
|
McpToolOverride
| Representasi JSON |
|---|
{
"tool": string,
"nameOverride": string,
"descriptionOverride": string,
"snapshot": {
object ( |
| Kolom | |
|---|---|
tool |
Wajib. Nama asli alat seperti yang ditampilkan oleh server MCP. |
nameOverride |
Opsional. Jika ada, alat ini akan menggunakan nama ini di Agen, bukan nama aslinya. Ini terutama digunakan sebagai alias jika server MCP menawarkan alat dengan nama yang buruk. |
descriptionOverride |
Opsional. Jika ada, alat ini akan menggunakan deskripsi ini, bukan deskripsi asli dari server. |
snapshot |
Hanya output. Jika ada, alat ini akan "Disematkan" dan menggunakan nilai snapshot sebagai pengganti jika server tidak tersedia untuk sementara atau jika tidak ada Penggantian. |
McpToolDefinition
| Representasi JSON |
|---|
{ "description": string, "inputSchema": { object ( |
| Kolom | |
|---|---|
description |
Hanya output. Deskripsi alat MCP. Hal ini dapat diganti oleh |
inputSchema |
Hanya output. Skema argumen input alat MCP. |
outputSchema |
Hanya output. Skema argumen output alat MCP. |
OpenApiToolset
| Representasi JSON |
|---|
{ "openApiSchema": string, "apiAuthentication": { object ( |
| Kolom | |
|---|---|
openApiSchema |
Wajib. Skema OpenAPI dari toolset. |
apiAuthentication |
Opsional. Informasi autentikasi yang diperlukan oleh API. |
tlsConfig |
Opsional. Konfigurasi TLS. Menyertakan sertifikat server kustom |
serviceDirectoryConfig |
Opsional. Konfigurasi Direktori Layanan. |
ignoreUnknownFields |
Opsional. Jika benar, agen akan mengabaikan kolom yang tidak diketahui dalam respons API untuk semua operasi yang ditentukan dalam skema OpenAPI. |
url |
Opsional. URL server skema Open API. Kolom ini hanya ditetapkan dalam toolset di dependensi lingkungan selama proses ekspor jika skema berisi URL server. Selama proses impor, jika URL ini ada dalam dependensi lingkungan dan skema memiliki placeholder $env_var, URL ini akan menggantikan placeholder dalam skema. |
ConnectorToolset
| Representasi JSON |
|---|
{ "connection": string, "authConfig": { object ( |
| Kolom | |
|---|---|
connection |
Wajib. Nama resource lengkap dari Koneksi Integration Connectors yang direferensikan. Format: |
authConfig |
Opsional. Mengonfigurasi cara penanganan autentikasi di Integration Connectors. Secara default, autentikasi admin diteruskan dalam permintaan API Integration Connectors. Anda dapat menggantinya dengan konfigurasi autentikasi pengguna akhir yang berbeda. Catatan: Koneksi harus mengaktifkan penggantian autentikasi untuk menentukan konfigurasi EUC di sini. Jika tidak, pembuatan Toolset akan gagal. Lihat: https://cloud.google.com/application-integration/docs/configure-connectors-task#configure-authentication-override |
connectorActions[] |
Wajib. Daftar tindakan konektor/operasi entity yang akan dibuatkan alatnya. |
PrebuiltAmbientNoise
Suara bising di sekitar bawaan.
| Enum | |
|---|---|
PREBUILT_AMBIENT_NOISE_UNSPECIFIED |
Tidak ditentukan. |
RETAIL_STORE |
Suara bising di sekitar toko retail. |
CONVENTION_HALL |
Suara bising di sekitar aula konvensi. |
OUTDOOR |
Suara bising di sekitar jalan. |
WarningType
Jenis peringatan yang muncul selama pemrosesan sampel suara.
| Enum | |
|---|---|
WARNING_TYPE_UNSPECIFIED |
Jenis peringatan yang tidak ditentukan. |
LOW_AUDIO_LEVEL |
Tingkat audio sampel suara terlalu rendah (misalnya, amplitudo RMS rendah). |
VoiceInstructionMode
Mode petunjuk untuk sampel suara.
| Enum | |
|---|---|
VOICE_INSTRUCTION_MODE_UNSPECIFIED |
Mode petunjuk tidak ditentukan. Defaultnya adalah NO_INSTRUCTION. |
NO_INSTRUCTION |
Tidak ada petunjuk suara yang akan digunakan. |
GENERATE_INSTRUCTION |
Petunjuk suara akan otomatis dibuat oleh AI dari sampel audio. |
CUSTOM_INSTRUCTION |
Petunjuk suara kustom yang diberikan oleh pengguna. |
ErrorHandlingStrategy
Menentukan strategi untuk menangani error.
| Enum | |
|---|---|
ERROR_HANDLING_STRATEGY_UNSPECIFIED |
Strategi penanganan error yang belum ditetapkan. |
NONE |
Tidak ada penanganan khusus yang diaktifkan. |
FALLBACK_RESPONSE |
Pesan penggantian akan ditampilkan kepada pengguna jika terjadi error sistem (misalnya, error LLM). |
END_SESSION |
Sinyal EndSession akan ditampilkan jika terjadi error sistem (misalnya, error LLM). |
ThinkingLevel
Konfigurasi tingkat penalaran untuk model.
| Enum | |
|---|---|
THINKING_LEVEL_UNSPECIFIED |
Tingkat penalaran tidak ditentukan. |
DEFAULT |
Tingkat penalaran default. |
LOW |
Tingkat penalaran rendah. |
MEDIUM |
Tingkat penalaran sedang. |
HIGH |
Tingkat penalaran tinggi. |
ToolExecutionMode
Menentukan perilaku eksekusi alat jika ada beberapa alat yang dipilih oleh agen secara bersamaan.
| Enum | |
|---|---|
TOOL_EXECUTION_MODE_UNSPECIFIED |
Mode eksekusi alat tidak ditentukan. Default-nya adalah PARALLEL. |
PARALLEL |
Jika ada beberapa alat yang dipilih, alat tersebut akan dijalankan secara paralel, dengan ToolContext yang sama. |
SEQUENTIAL |
Jika ada beberapa alat yang dipilih, alat tersebut akan dijalankan secara berurutan. Alat berikutnya hanya akan dijalankan setelah alat sebelumnya selesai dan dapat melihat ToolContext yang diperbarui dari alat sebelumnya. |
SemanticSimilarityChannel
Saluran kemiripan semantik yang akan digunakan.
| Enum | |
|---|---|
SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED |
Metrik tidak ditentukan. Default-nya adalah TEXT. |
TEXT |
Gunakan kesamaan semantik teks. |
AUDIO |
Gunakan kesamaan semantik audio. |
ExtraToolCallBehavior
Menentukan perilaku saat panggilan alat tambahan ditemukan. Panggilan alat tambahan adalah panggilan alat yang ada dalam eksekusi, tetapi tidak cocok dengan panggilan alat apa pun dalam ekspektasi ideal.
| Enum | |
|---|---|
EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED |
Perilaku tidak ditentukan. Nilai defaultnya adalah FAIL. |
FAIL |
Gagalkan evaluasi jika ditemukan panggilan alat tambahan. |
ALLOW |
Izinkan panggilan alat tambahan. |
HallucinationMetricBehavior
Perilaku metrik halusinasi. Terlepas dari perilakunya, metrik akan selalu dihitung. Perbedaannya adalah jika dinonaktifkan, metrik tidak digunakan untuk menghitung skor evaluasi keseluruhan.
| Enum | |
|---|---|
HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED |
Perilaku metrik halusinasi yang tidak ditentukan. |
DISABLED |
Menonaktifkan metrik halusinasi. |
ENABLED |
Aktifkan metrik halusinasi. |
Jenis
Jenis data OpenAPI.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Jenis tidak ditentukan. |
STRING |
Jenis string. |
INTEGER |
Jenis bilangan bulat. |
NUMBER |
Jenis nomor. |
BOOLEAN |
Jenis boolean. |
OBJECT |
Jenis objek. |
ARRAY |
Jenis array. |
NullValue
Merepresentasikan null JSON.
NullValue adalah sentinel, yang menggunakan enum dengan hanya satu nilai untuk merepresentasikan nilai null untuk gabungan jenis Value.
Kolom jenis NullValue dengan nilai selain 0 dianggap tidak valid. Sebagian besar serializer ProtoJSON akan memunculkan Value dengan null_value yang ditetapkan sebagai null JSON, terlepas dari nilai bilangan bulatnya, sehingga akan melakukan perjalanan pulang pergi ke nilai 0.
| Enum | |
|---|---|
NULL_VALUE |
Nilai null. |
Jenis
Jenis mesin. Lihat dokumentasi yang tersedia di https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1/SolutionType dan https://cloud.google.com/generative-ai-app-builder/docs/create-datastore-ingest.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Jenis mesin tidak ditentukan. |
ENGINE_TYPE_SEARCH |
Mesin SOLUTION_TYPE_SEARCH untuk aplikasi. Semua penyimpanan data konektor yang ditambahkan ke aplikasi akan ditambahkan ke mesin ini. |
ENGINE_TYPE_CHAT |
Jenis mesin chat. Mesin SOLUTION_TYPE_CHAT untuk aplikasi. Semua penyimpanan data konektor yang ditambahkan ke aplikasi akan ditambahkan ke mesin ini. |
ChannelType
Jenis profil saluran.
| Enum | |
|---|---|
UNKNOWN |
Jenis saluran tidak diketahui. |
WEB_UI |
Saluran UI Web. |
API |
Saluran API. |
TWILIO |
Saluran Twilio. |
GOOGLE_TELEPHONY_PLATFORM |
Saluran 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 |
Saluran Five9. |
CONTACT_CENTER_INTEGRATION |
Saluran integrasi pusat kontak pihak ketiga. |
WHATSAPP |
Saluran WhatsApp. |
INSTAGRAM |
Instagram. |
Persona
Persona channel.
| Enum | |
|---|---|
UNKNOWN |
Persona UNKNOWN. |
CONCISE |
Agen memberikan respons yang ringkas dan langsung pada 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. |
RequestLocation
Lokasi kunci API dalam permintaan.
| Enum | |
|---|---|
REQUEST_LOCATION_UNSPECIFIED |
Tidak ditentukan. Nilai ini tidak boleh digunakan. |
HEADER |
Merepresentasikan kunci di header http. |
QUERY_STRING |
Merepresentasikan kunci dalam string kueri. |
OauthGrantType
Jenis pemberian izin OAuth. Hanya pemberian kredensial klien yang didukung.
| Enum | |
|---|---|
OAUTH_GRANT_TYPE_UNSPECIFIED |
Tidak ditentukan. Default-nya adalah CLIENT_CREDENTIAL. |
CLIENT_CREDENTIAL |
Mewakili alur kredensial klien. |
Arah
Arah transfer.
| Enum | |
|---|---|
DIRECTION_UNSPECIFIED |
Arah tidak ditentukan. |
PARENT_TO_CHILD |
Transfer dari agen induk ke agen turunan. |
CHILD_TO_PARENT |
Transfer dari agen turunan ke agen induk. |
OperationType
Operasi yang akan dilakukan pada entity.
| Enum | |
|---|---|
OPERATION_TYPE_UNSPECIFIED |
Jenis operasi belum ditentukan. Tidak valid, pembuatan/pembaruan ConnectorTool akan gagal. |
LIST |
Operasi daftar. |
GET |
Mendapatkan operasi. |
CREATE |
Operasi pembuatan. |
UPDATE |
Operasi update. |
DELETE |
Operasi penghapusan. |
DataStoreType
Jenis penyimpanan data.
| Enum | |
|---|---|
DATA_STORE_TYPE_UNSPECIFIED |
Tidak ditentukan. Nilai ini menunjukkan bahwa jenis penyimpanan data tidak ditentukan, sehingga tidak akan digunakan selama penelusuran. |
PUBLIC_WEB |
Penyimpanan data yang berisi konten web publik. |
UNSTRUCTURED |
Penyimpanan data yang berisi data pribadi tidak terstruktur. |
FAQ |
Penyimpanan data yang berisi data terstruktur yang digunakan sebagai FAQ. |
CONNECTOR |
Penyimpanan data yang merupakan konektor ke layanan pihak pertama atau pihak ketiga. |
DocumentProcessingMode
Mode pemrosesan dokumen penyimpanan data.
| Enum | |
|---|---|
DOCUMENT_PROCESSING_MODE_UNSPECIFIED |
Tidak ditentukan. |
DOCUMENTS |
Dokumen diproses sebagai dokumen. |
CHUNKS |
Dokumen dikonversi menjadi potongan. |
AttributeType
Atribut (atau fungsi) yang akan diterapkan ke peringkat kustom.
| Enum | |
|---|---|
ATTRIBUTE_TYPE_UNSPECIFIED |
AttributeType tidak ditentukan. |
NUMERICAL |
Nilai kolom numerik akan digunakan untuk memperbarui jumlah penguatan secara dinamis. Dalam hal ini, attribute_value (nilai x) dari titik kontrol akan menjadi nilai sebenarnya dari kolom numerik yang boost_amount-nya ditentukan. |
FRESHNESS |
Untuk kasus penggunaan keaktualan, nilai atribut akan berupa durasi antara waktu saat ini dan tanggal di kolom datetime yang ditentukan. Nilai harus diformat sebagai nilai dayTimeDuration XSD (subset terbatas dari nilai durasi ISO 8601). Polanya adalah: [nD][T[nH][nM][nS]]. Misalnya, 5D, 3DT12H30M, T24H. |
InterpolationType
Jenis interpolasi yang akan diterapkan. Defaultnya adalah linear (Linear Sepotong-Sepotong).
| Enum | |
|---|---|
INTERPOLATION_TYPE_UNSPECIFIED |
Jenis interpolasi tidak ditentukan. Dalam hal ini, setelan defaultnya adalah Linear. |
LINEAR |
Interpolasi linear sepotong-sepotong akan diterapkan. |
ModalityType
Jenis modalitas.
| Enum | |
|---|---|
MODALITY_TYPE_UNSPECIFIED |
Jenis modalitas tidak ditentukan. |
TEXT |
Modalitas teks. |
AUDIO |
Modalitas audio. |
FilterParameterBehavior
Perilaku parameter filter.
| Enum | |
|---|---|
FILTER_PARAMETER_BEHAVIOR_UNSPECIFIED |
Perilaku filter default. Sertakan parameter filter untuk datastore konektor. Untuk jenis datastore lainnya, parameter input filter dihilangkan. |
ALWAYS_INCLUDE |
Selalu sertakan parameter filter untuk semua jenis datastore. |
NEVER_INCLUDE |
Parameter filter tidak pernah disertakan dalam daftar parameter alat, apa pun jenis datastore-nya. |
Negara bagian/Provinsi
Menunjukkan status ketersediaan dinamis alat.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Status default. |
ACTIVE |
Alat ini tersedia dan ditawarkan secara aktif oleh server. |
INACTIVE |
Alat dikonfigurasi atau disematkan, tetapi saat ini tidak ditawarkan oleh server. |
STALE |
Alat ini ada di server, tetapi tidak cocok dengan versi di server. |
CorpusType
Jenis korpus Vertex RAG.
| Enum | |
|---|---|
CORPUS_TYPE_UNSPECIFIED |
Jenis korpus tidak ditentukan. |
USER_OWNED |
Korpus dibuat dan dimiliki oleh pengguna. |
FULLY_MANAGED |
Korpus dibuat oleh agen. |
WidgetType
Semua jenis widget yang tersedia. Nilai baru dapat ditambahkan ke enum ini pada masa mendatang.
| Enum | |
|---|---|
WIDGET_TYPE_UNSPECIFIED |
Jenis widget tidak ditentukan. |
CUSTOM |
Jenis widget kustom. |
PRODUCT_CAROUSEL |
Widget carousel produk. |
PRODUCT_DETAILS |
Widget detail produk. |
QUICK_ACTIONS |
Widget tindakan cepat. |
PRODUCT_COMPARISON |
Widget perbandingan produk. |
ADVANCED_PRODUCT_DETAILS |
Widget detail produk lanjutan. |
SHORT_FORM |
Widget formulir singkat. |
OVERALL_SATISFACTION |
Widget kepuasan secara keseluruhan. |
ORDER_SUMMARY |
Widget ringkasan pesanan. |
APPOINTMENT_DETAILS |
Widget detail janji temu. |
APPOINTMENT_SCHEDULER |
Widget penjadwal janji temu. |
CONTACT_FORM |
Widget formulir kontak. |
Mode
Strategi yang digunakan untuk memetakan data dari alat sumber ke widget.
| Enum | |
|---|---|
MODE_UNSPECIFIED |
Mode tidak ditentukan. |
FIELD_MAPPING |
Gunakan peta field_mappings untuk transformasi data. |
PYTHON_SCRIPT |
Gunakan python_script untuk transformasi data. |
Jenis
Menentukan cara respons teks dihasilkan.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Jenis tidak ditentukan. |
NONE |
LLM secara dinamis memutuskan apakah akan menghasilkan respons teks bersama widget berdasarkan konteks percakapan. |
LLM_GENERATED |
LLM secara eksplisit diperlukan untuk menghasilkan respons teks. |
STATIC |
Respons teks statis yang telah ditentukan sebelumnya selalu digunakan. |
ExecutionType
Jenis eksekusi alat atau toolset.
| Enum | |
|---|---|
EXECUTION_TYPE_UNSPECIFIED |
Jenis eksekusi tidak ditentukan. Setelan defaultnya adalah SYNCHRONOUS jika tidak ditentukan. |
SYNCHRONOUS |
Alat ini dijalankan secara sinkron. Sesi akan diblokir hingga alat merespons. |
ASYNCHRONOUS |
Alat ini dijalankan secara asinkron. Sesi akan berlanjut saat alat dijalankan. |
MatchType
Jenis pencocokan untuk filter konten.
| Enum | |
|---|---|
MATCH_TYPE_UNSPECIFIED |
Jenis pencocokan tidak ditentukan. |
SIMPLE_STRING_MATCH |
Konten dicocokkan untuk substring karakter demi karakter. |
WORD_BOUNDARY_STRING_MATCH |
Konten hanya cocok jika pola yang ditemukan dalam teks dikelilingi oleh pembatas kata. Frasa yang dilarang juga dapat berisi pembatas kata. |
REGEXP_MATCH |
Konten dicocokkan menggunakan sintaksis ekspresi reguler. |
SENSITIVE_WORDS |
Konten dicocokkan dengan daftar kata dan frasa sensitif yang dikelola sistem. Memasang guardrail dengan jenis pencocokan ini ke aplikasi atau agen akan menggantikan filter kata sensitif default untuk agen yang terpengaruh; nonaktifkan guardrail untuk memilih tidak menggunakan filter default. |
PolicyScope
Menentukan kapan harus menerapkan pemeriksaan kebijakan selama percakapan.
| Enum | |
|---|---|
POLICY_SCOPE_UNSPECIFIED |
Cakupan kebijakan tidak ditentukan. |
USER_QUERY |
Pemeriksaan kebijakan dipicu pada input pengguna. |
AGENT_RESPONSE |
Pemeriksaan kebijakan dipicu pada respons agen. Menerapkan cakupan kebijakan ini akan menimbulkan latensi tambahan sebelum agen dapat merespons. |
USER_QUERY_AND_AGENT_RESPONSE |
Pemeriksaan kebijakan dipicu pada input pengguna dan respons agen. Menerapkan cakupan kebijakan ini akan menimbulkan latensi tambahan sebelum agen dapat merespons. |
HarmCategory
Kategori bahaya.
| Enum | |
|---|---|
HARM_CATEGORY_UNSPECIFIED |
Kategori bahaya tidak ditentukan. |
HARM_CATEGORY_HATE_SPEECH |
Kategori bahayanya adalah ujaran kebencian. |
HARM_CATEGORY_DANGEROUS_CONTENT |
Kategori bahayanya adalah konten berbahaya. |
HARM_CATEGORY_HARASSMENT |
Kategori bahayanya adalah pelecehan. |
HARM_CATEGORY_SEXUALLY_EXPLICIT |
Kategori bahayanya adalah konten seksual vulgar. |
HARM_CATEGORY_PROFANITY |
Kategori bahaya adalah kata-kata tidak sopan. |
HARM_CATEGORY_TOXIC |
Kategori bahayanya adalah beracun. |
HarmBlockThreshold
Tingkat nilai minimum berbasis probabilitas untuk pemblokiran.
| Enum | |
|---|---|
HARM_BLOCK_THRESHOLD_UNSPECIFIED |
Batas blokir bahaya yang tidak ditentukan. |
BLOCK_LOW_AND_ABOVE |
Blokir nilai minimum rendah dan yang lebih tinggi (yaitu, blokir lebih banyak). |
BLOCK_MEDIUM_AND_ABOVE |
Blokir nilai minimum sedang dan yang lebih tinggi. |
BLOCK_ONLY_HIGH |
Blokir hanya nilai minimum tinggi (yaitu, blokir lebih sedikit). |
BLOCK_NONE |
Jangan blokir. |
OFF |
Nonaktifkan filter keamanan. |
Jenis
Jenis pengawas.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Jenis tidak ditentukan. |
INVALID_TEXT |
Jenis masalah teks tidak valid. |
LANGUAGE_SHIFT |
Jenis masalah peralihan bahasa. |
SPEAKER_SHIFT |
Jenis masalah pergantian speaker. |
AUDIO_MISMATCH |
Jenis masalah ketidakcocokan audio. |
MISSING_TOOL_CALL |
Jenis masalah panggilan alat tidak ada. |
CUSTOM |
Jenis masalah kustom. |
CHOPPY_AUDIO |
Jenis masalah audio terputus-putus. |
PROFANITY |
Jenis masalah kata-kata tidak sopan agen. |
DetectionMode
Mode deteksi supervisor.
| Enum | |
|---|---|
DETECTION_MODE_UNSPECIFIED |
Mode deteksi tidak ditentukan. Defaultnya adalah NON_BLOCKING. |
NON_BLOCKING |
Mode deteksi tanpa pemblokiran. Respons tidak diblokir saat deteksi pengawas sedang berlangsung. |
BLOCKING |
Mode deteksi pemblokiran. Respons diblokir saat deteksi pengawas sedang berlangsung. |
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 tersebut dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim kepada pengguna.
Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:
readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah, alat hanya dapat melakukan tindakan aditif. Default: true.idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌