Alat: update_app
Mengupdate aplikasi yang ditentukan. Pastikan untuk selalu meneruskan update mask dalam input.
Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP update_app.
| 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": "update_app", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Skema Input
Pesan permintaan untuk AgentService.UpdateApp.
UpdateAppRequest
| Representasi JSON |
|---|
{
"app": {
object ( |
| Kolom | |
|---|---|
app |
Wajib. Aplikasi yang akan diupdate. |
updateMask |
Opsional. Masker kolom digunakan untuk mengontrol kolom mana yang akan diperbarui. Jika mask tidak ada, semua kolom akan diperbarui. Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya valid. Contoh: |
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 |
|
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. |
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: |
FieldMask
| Representasi JSON |
|---|
{ "paths": [ string ] } |
| Kolom | |
|---|---|
paths[] |
Kumpulan jalur mask kolom. |
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. |
Skema Output
Aplikasi berfungsi sebagai container tingkat teratas untuk sekelompok agen, termasuk agen root dan sub-agennya, beserta konfigurasi terkaitnya. Agen-agen ini bekerja sama untuk mencapai sasaran tertentu dalam konteks 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 |
|
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. |
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: |
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. |
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: ❌