REST Resource: projects.locations.apps

Resource: App

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.

Representasi JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "pinned": boolean,
  "rootAgent": string,
  "languageSettings": {
    object (LanguageSettings)
  },
  "timeZoneSettings": {
    object (TimeZoneSettings)
  },
  "audioProcessingConfig": {
    object (AudioProcessingConfig)
  },
  "loggingSettings": {
    object (LoggingSettings)
  },
  "errorHandlingSettings": {
    object (ErrorHandlingSettings)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "toolExecutionMode": enum (App.ToolExecutionMode),
  "evaluationMetricsThresholds": {
    object (EvaluationMetricsThresholds)
  },
  "variableDeclarations": [
    {
      object (App.VariableDeclaration)
    }
  ],
  "predefinedVariableDeclarations": [
    {
      object (App.VariableDeclaration)
    }
  ],
  "globalInstruction": string,
  "guardrails": [
    string
  ],
  "dataStoreSettings": {
    object (DataStoreSettings)
  },
  "defaultChannelProfile": {
    object (ChannelProfile)
  },
  "metadata": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "deploymentCount": integer,
  "clientCertificateSettings": {
    object (ClientCertificateSettings)
  },
  "vpcScSettings": {
    object (VpcScSettings)
  },
  "locked": boolean,
  "evaluationPersonas": [
    {
      object (EvaluationPersona)
    }
  ],
  "evaluationSettings": {
    object (EvaluationSettings)
  },
  "validationErrors": [
    string
  ],
  "dashboardSettings": {
    object (DashboardSettings)
  }
}
Kolom
name

string

ID. ID unik aplikasi. Format: projects/{project}/locations/{location}/apps/{app}

displayName

string

Wajib. Nama tampilan aplikasi.

description

string

Opsional. Deskripsi aplikasi yang dapat dibaca manusia.

pinned

boolean

Opsional. Apakah aplikasi disematkan di daftar aplikasi.

rootAgent

string

Opsional. Agen root adalah titik entri aplikasi. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

languageSettings

object (LanguageSettings)

Opsional. Setelan bahasa aplikasi.

timeZoneSettings

object (TimeZoneSettings)

Opsional. Setelan TimeZone aplikasi.

audioProcessingConfig

object (AudioProcessingConfig)

Opsional. Konfigurasi pemrosesan audio aplikasi.

loggingSettings

object (LoggingSettings)

Opsional. Setelan pencatatan log aplikasi.

errorHandlingSettings

object (ErrorHandlingSettings)

Opsional. Setelan penanganan error aplikasi.

modelSettings

object (ModelSettings)

Opsional. Setelan model LLM default untuk aplikasi. Setiap resource (misalnya, agen, guardrail) dapat mengganti konfigurasi ini sesuai kebutuhan.

toolExecutionMode

enum (App.ToolExecutionMode)

Opsional. Mode eksekusi alat untuk aplikasi. Jika tidak diberikan, akan ditetapkan secara default ke PARALLEL.

evaluationMetricsThresholds

object (EvaluationMetricsThresholds)

Opsional. Batas evaluasi untuk aplikasi.

variableDeclarations[]

object (App.VariableDeclaration)

Opsional. Deklarasi variabel.

predefinedVariableDeclarations[]

object (App.VariableDeclaration)

Hanya output. Deklarasi variabel yang telah ditetapkan untuk aplikasi.

globalInstruction

string

Opsional. Petunjuk untuk semua agen di aplikasi. Anda dapat menggunakan petunjuk ini untuk menyiapkan identitas atau kepribadian yang stabil di semua agen.

guardrails[]

string

Opsional. Daftar guardrail untuk aplikasi. Format: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}

dataStoreSettings

object (DataStoreSettings)

Opsional. Setelan penyimpanan data untuk aplikasi.

defaultChannelProfile

object (ChannelProfile)

Opsional. Profil saluran default yang digunakan oleh aplikasi.

metadata

map (key: string, value: string)

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 "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

createTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

etag

string

Hanya output. Etag yang digunakan untuk memastikan objek tidak berubah selama operasi baca-ubah-tulis. Jika etag kosong, update akan menimpa perubahan serentak.

deploymentCount

integer

Hanya output. Jumlah deployment di aplikasi.

clientCertificateSettings

object (ClientCertificateSettings)

Opsional. Setelan sertifikat klien default untuk aplikasi.

vpcScSettings

object (VpcScSettings)

Opsional. Setelan VPC-SC untuk aplikasi.

locked

boolean

Opsional. Menunjukkan apakah aplikasi dikunci untuk perubahan. Jika aplikasi dikunci, perubahan pada resource aplikasi akan ditolak.

evaluationPersonas[]

object (EvaluationPersona)

Opsional. Persona evaluasi untuk aplikasi. Kolom ini digunakan untuk menentukan persona yang dapat digunakan untuk evaluasi. Maksimum 30 persona dapat ditentukan.

evaluationSettings

object (EvaluationSettings)

Opsional. Setelan evaluasi untuk aplikasi.

validationErrors[]

string

Hanya output. Kesalahan konfigurasi atau peringatan di aplikasi.

dashboardSettings

object (DashboardSettings)

Opsional. Setelan dasbor khusus aplikasi untuk menautkan dan mengonfigurasi dasbor Contact Center Insights.

LanguageSettings

Setelan bahasa aplikasi.

Representasi JSON
{
  "defaultLanguageCode": string,
  "supportedLanguageCodes": [
    string
  ],
  "enableMultilingualSupport": boolean,
  "fallbackAction": string
}
Kolom
defaultLanguageCode

string

Opsional. Kode bahasa default aplikasi.

supportedLanguageCodes[]

string

Opsional. Daftar kode bahasa yang didukung oleh aplikasi, selain defaultLanguageCode.

enableMultilingualSupport

boolean

Opsional. Mengaktifkan dukungan multibahasa. Jika true, agen di aplikasi akan menggunakan petunjuk bawaan untuk meningkatkan penanganan input multibahasa.

fallbackAction
(deprecated)

string

Opsional. Tidak digunakan lagi: Fitur ini tidak lagi didukung. Gunakan enableMultilingualSupport untuk meningkatkan penanganan input multibahasa. Tindakan yang harus dilakukan saat agen menerima input dalam bahasa yang tidak didukung.

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 EndSession dengan metadata yang sesuai untuk menghentikan percakapan.

TimeZoneSettings

Setelan TimeZone aplikasi.

Representasi JSON
{
  "timeZone": string
}
Kolom
timeZone

string

Opsional. Zona waktu aplikasi dari database zona waktu, misalnya, America/Los_Angeles, Europe/Paris.

AudioProcessingConfig

Konfigurasi untuk cara audio input dan output harus diproses dan dikirimkan.

Representasi JSON
{
  "synthesizeSpeechConfigs": {
    string: {
      object (SynthesizeSpeechConfig)
    },
    ...
  },
  "bargeInConfig": {
    object (BargeInConfig)
  },
  "inactivityTimeout": string,
  "ambientSoundConfig": {
    object (AmbientSoundConfig)
  },
  "customVoiceSamples": [
    {
      object (CustomVoiceSample)
    }
  ]
}
Kolom
synthesizeSpeechConfigs

map (key: string, value: object (SynthesizeSpeechConfig))

Opsional. Konfigurasi cara respons agen harus disintesis, pemetaan dari kode bahasa ke SynthesizeSpeechConfig.

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 "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

bargeInConfig

object (BargeInConfig)

Opsional. Mengonfigurasi perilaku agen untuk aktivitas penyelaan pengguna.

inactivityTimeout

string (Duration format)

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 's'. Contoh: "3.5s".

ambientSoundConfig

object (AmbientSoundConfig)

Opsional. Konfigurasi untuk suara sekitar yang akan diputar dengan respons agen yang disintesis, untuk meningkatkan kealamian percakapan.

customVoiceSamples[]

object (CustomVoiceSample)

Opsional. Mengonfigurasi sampel suara kustom untuk kloning suara.

SynthesizeSpeechConfig

Konfigurasi untuk cara respons agen harus disintesis.

Representasi JSON
{
  "voice": string,
  "speakingRate": number,
  "model": string,
  "instruction": string
}
Kolom
voice

string

Opsional. Nama suara. Jika tidak ditetapkan, layanan akan memilih suara berdasarkan parameter lain seperti languageCode.

Untuk mengetahui daftar suara yang tersedia, lihat Suara dan bahasa yang didukung dari Cloud Text-to-Speech.

speakingRate

number

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

string

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

string

Opsional. Petunjuk yang digunakan untuk menyintesis ucapan saat menggunakan model generatif.

BargeInConfig

Konfigurasi untuk cara menangani aktivitas penyelaan pengguna.

Representasi JSON
{
  "disableBargeIn": boolean,
  "bargeInAwareness": boolean
}
Kolom
disableBargeIn
(deprecated)

boolean

Opsional. Tidak digunakan lagi: disableBargeIn tidak digunakan lagi dan digantikan dengan disableBargeInControl di ChannelProfile.

Menonaktifkan interupsi pengguna saat agen berbicara. Jika true, input pengguna selama pemutaran respons agen akan diabaikan.

bargeInAwareness

boolean

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.

AmbientSoundConfig

Konfigurasi untuk suara sekitar yang akan diputar dengan respons agen yang disintesis, untuk meningkatkan kealamian percakapan.

Representasi JSON
{
  "volumeGainDb": number,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "prebuiltAmbientNoise": enum (AmbientSoundConfig.PrebuiltAmbientNoise),
  "gcsUri": string,
  "prebuiltAmbientSound": string
  // End of mutually exclusive fields.
}
Kolom
volumeGainDb

number

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.

Suara bising di sekitar yang akan diputar dengan respons agen yang disintesis, untuk meningkatkan kealamian percakapan. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
prebuiltAmbientNoise
(deprecated)

enum (AmbientSoundConfig.PrebuiltAmbientNoise)

Opsional. Tidak digunakan lagi: prebuiltAmbientNoise tidak digunakan lagi dan digantikan dengan prebuiltAmbientSound.

gcsUri

string

Opsional. Suara bising di sekitar sebagai file WAV mono-channel 16 kHz yang disimpan di Cloud Storage.

Catatan: Pastikan agen layanan CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com memiliki izin storage.objects.get ke objek Cloud Storage.

prebuiltAmbientSound

string

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"

Akhir kolom yang saling eksklusif.

AmbientSoundConfig.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.

CustomVoiceSample

Konfigurasi untuk sampel suara kustom yang digunakan untuk kloning suara.

Representasi JSON
{
  "name": string,
  "voiceSampleGcsUri": string,
  "consentAudioGcsUri": string,
  "voiceInstruction": string,
  "previewAudioContent": string,
  "previewText": string,
  "warnings": [
    {
      object (CustomVoiceSample.Warning)
    }
  ],
  "voiceInstructionMode": enum (CustomVoiceSample.VoiceInstructionMode)
}
Kolom
name

string

Opsional. Nama yang ditentukan pengguna untuk sampel suara kustom.

voiceSampleGcsUri

string

Opsional. Cloud Storage URI ke sampel audio untuk kloning suara. Sampel audio harus berupa file WAV mono-channel 24 kHz.

consentAudioGcsUri

string

Opsional. Audio izin untuk kloning suara.

voiceInstruction

string

Opsional. Petunjuk bahasa alami untuk gaya, nada, kecepatan, atau pengucapan suara.

previewAudioContent

string (bytes format)

Hanya output. Audio pratinjau yang disintesis untuk suara kustom, diformat sebagai WAV kanonis (LINEAR16, 24 kHz, 16-bit, mono).

String berenkode base64.

previewText

string

Opsional. Teks untuk menyintesis audio pratinjau untuk suara kustom.

warnings[]

object (CustomVoiceSample.Warning)

Hanya output. Pesan peringatan yang muncul selama pemrosesan klon suara (misalnya, level audio rendah).

voiceInstructionMode

enum (CustomVoiceSample.VoiceInstructionMode)

Opsional. Mode petunjuk untuk sampel suara. Jika tidak ditentukan, defaultnya adalah NO_INSTRUCTION.

CustomVoiceSample.Warning

Pesan peringatan yang muncul selama pemrosesan sampel suara.

Representasi JSON
{
  "message": string,
  "type": enum (CustomVoiceSample.Warning.WarningType)
}
Kolom
message

string

Hanya output. Deskripsi peringatan yang dapat dibaca manusia.

type

enum (CustomVoiceSample.Warning.WarningType)

Hanya output. Jenis peringatan.

CustomVoiceSample.Warning.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).

CustomVoiceSample.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.

LoggingSettings

Setelan untuk menjelaskan perilaku logging aplikasi.

Representasi JSON
{
  "redactionConfig": {
    object (RedactionConfig)
  },
  "audioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "unredactedAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "bigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "unredactedBigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "cloudLoggingSettings": {
    object (CloudLoggingSettings)
  },
  "conversationLoggingSettings": {
    object (ConversationLoggingSettings)
  },
  "evaluationAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "metricAnalysisSettings": {
    object (MetricAnalysisSettings)
  },
  "requiredRecordingConsent": boolean
}
Kolom
redactionConfig

object (RedactionConfig)

Opsional. Konfigurasi untuk cara menyamarkan data sensitif.

audioRecordingConfig

object (AudioRecordingConfig)

Opsional. Konfigurasi untuk cara perekaman interaksi audio. Audio dapat diredaksi seperti yang dikonfigurasi di RedactionConfig.

unredactedAudioRecordingConfig

object (AudioRecordingConfig)

Opsional. Mengonfigurasi rekaman tambahan audio yang tidak disamarkan. Hal ini dapat digunakan untuk mempertahankan salinan audio mentah saat penyuntingan audio enabled, biasanya untuk tujuan audit atau pemantauan.

bigqueryExportSettings

object (BigQueryExportSettings)

Opsional. Mengonfigurasi perilaku BigQuery Export untuk aplikasi. Data percakapan dapat diredaksi seperti yang dikonfigurasi di RedactionConfig.

unredactedBigqueryExportSettings

object (BigQueryExportSettings)

Opsional. Mengonfigurasi perilaku BigQuery Export untuk aplikasi. Data percakapan yang tidak diredaksi akan diekspor ke Tabel BigQuery jika diaktifkan.

cloudLoggingSettings

object (CloudLoggingSettings)

Opsional. Setelan untuk mendeskripsikan perilaku Cloud Logging untuk aplikasi.

conversationLoggingSettings

object (ConversationLoggingSettings)

Opsional. Setelan untuk mendeskripsikan perilaku logging percakapan untuk aplikasi.

evaluationAudioRecordingConfig

object (AudioRecordingConfig)

Opsional. Konfigurasi cara interaksi audio harus direkam untuk evaluasi. Secara default, perekaman audio tidak diaktifkan untuk sesi evaluasi.

metricAnalysisSettings

object (MetricAnalysisSettings)

Opsional. Setelan untuk mendeskripsikan perilaku pengumpulan data percakapan untuk pipeline analisis LLM untuk aplikasi.

RedactionConfig

Konfigurasi untuk menginstruksikan cara penanganan data sensitif.

Representasi JSON
{
  "enableRedaction": boolean,
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
Kolom
enableRedaction

boolean

Opsional. Jika true, penyuntingan akan diterapkan dalam berbagai skenario logging, termasuk histori percakapan, Cloud Logging, dan rekaman audio.

inspectTemplate

string

Opsional. Nama template pemeriksaan DLP untuk mengonfigurasi deteksi jenis data sensitif.

Format: projects/{project}/locations/{location}/inspectTemplates/{inspectTemplate}

deidentifyTemplate

string

Opsional. Nama template de-identifikasi DLP untuk memberikan petunjuk tentang cara melakukan de-identifikasi konten.

Format: projects/{project}/locations/{location}/deidentifyTemplates/{deidentifyTemplate}

AudioRecordingConfig

Konfigurasi untuk cara perekaman interaksi audio.

Representasi JSON
{
  "gcsBucket": string,
  "gcsPathPrefix": string
}
Kolom
gcsBucket

string

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 storage.objects.create kepada agen layanan CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com.

gcsPathPrefix

string

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 $project/$location/$app/$date/$session/ akan digunakan.

BigQueryExportSettings

Setelan untuk mendeskripsikan perilaku BigQuery Export untuk aplikasi.

Representasi JSON
{
  "enabled": boolean,
  "project": string,
  "dataset": string
}
Kolom
enabled

boolean

Opsional. Menunjukkan apakah BigQuery Export diaktifkan.

project

string

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 roles/bigquery.admin kepada agen layanan CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com.

dataset

string

Opsional. ID set data BigQuery untuk mengekspor data.

CloudLoggingSettings

Setelan untuk mendeskripsikan perilaku Cloud Logging untuk aplikasi.

Representasi JSON
{
  "enableCloudLogging": boolean
}
Kolom
enableCloudLogging

boolean

Opsional. Apakah akan mengaktifkan Cloud Logging untuk sesi.

ConversationLoggingSettings

Setelan untuk mendeskripsikan perilaku logging percakapan untuk aplikasi.

Representasi JSON
{
  "disableConversationLogging": boolean,
  "retentionWindow": string
}
Kolom
disableConversationLogging

boolean

Opsional. Apakah akan menonaktifkan logging percakapan untuk sesi.

retentionWindow

string (Duration format)

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 's'. Contoh: "3.5s".

MetricAnalysisSettings

Setelan untuk mendeskripsikan perilaku pengumpulan data percakapan untuk pipeline metrik analisis LLM.

Representasi JSON
{
  "llmMetricsOptedOut": boolean
}
Kolom
llmMetricsOptedOut

boolean

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

Setelan untuk menjelaskan cara penanganan error di aplikasi.

Representasi JSON
{
  "errorHandlingStrategy": enum (ErrorHandlingSettings.ErrorHandlingStrategy),
  "fallbackResponseConfig": {
    object (ErrorHandlingSettings.FallbackResponseConfig)
  },
  "endSessionConfig": {
    object (ErrorHandlingSettings.EndSessionConfig)
  }
}
Kolom
errorHandlingStrategy

enum (ErrorHandlingSettings.ErrorHandlingStrategy)

Opsional. Strategi yang akan digunakan untuk penanganan error.

fallbackResponseConfig

object (ErrorHandlingSettings.FallbackResponseConfig)

Opsional. Konfigurasi untuk menangani respons penggantian.

endSessionConfig

object (ErrorHandlingSettings.EndSessionConfig)

Opsional. Konfigurasi untuk mengakhiri sesi jika terjadi error sistem (misalnya, error LLM).

ErrorHandlingSettings.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).

ErrorHandlingSettings.FallbackResponseConfig

Konfigurasi untuk menangani respons penggantian.

Representasi JSON
{
  "customFallbackMessages": {
    string: string,
    ...
  },
  "maxFallbackAttempts": integer
}
Kolom
customFallbackMessages

map (key: string, value: string)

Opsional. Pesan penggantian jika terjadi error sistem (misalnya, error LLM), yang dipetakan berdasarkan kode bahasa yang didukung.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

maxFallbackAttempts

integer

Opsional. Jumlah maksimum upaya penggantian yang akan dilakukan sebelum agen memunculkan Sinyal EndSession.

ErrorHandlingSettings.EndSessionConfig

Konfigurasi untuk mengakhiri sesi jika terjadi error sistem (misalnya, error LLM).

Representasi JSON
{
  "escalateSession": boolean
}
Kolom
escalateSession

boolean

Opsional. Apakah akan mengeskalasi sesi di EndSession. Jika sesi dieskalasi, metadata in EndSession akan berisi sessionEscalated = true. Lihat https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/deploy/google-telephony-platform#transfer_a_call_to_a_human_agent untuk mengetahui detailnya.

App.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.

App.VariableDeclaration

Menentukan struktur dan metadata untuk variabel.

Representasi JSON
{
  "name": string,
  "description": string,
  "schema": {
    object (Schema)
  }
}
Kolom
name

string

Wajib. Nama variabel. Nama harus diawali dengan huruf atau garis bawah dan hanya berisi huruf, angka, atau garis bawah.

description

string

Wajib. Deskripsi variabel.

schema

object (Schema)

Wajib. Skema variabel.

DataStoreSettings

Setelan terkait penyimpanan data untuk aplikasi.

Representasi JSON
{
  "engines": [
    {
      object (DataStoreSettings.Engine)
    }
  ]
}
Kolom
engines[]

object (DataStoreSettings.Engine)

Hanya output. Mesin untuk aplikasi.

DataStoreSettings.Engine

Mesin yang terhubung ke penyimpanan data. Lihat Vertex AI Search: https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction.

Representasi JSON
{
  "name": string,
  "type": enum (DataStoreSettings.Engine.Type)
}
Kolom
name

string

Hanya output. Nama resource mesin. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}

type

enum (DataStoreSettings.Engine.Type)

Hanya output. Jenis mesin.

DataStoreSettings.Engine.Type

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_CHAT Jenis mesin chat. Mesin SOLUTION_TYPE_CHAT untuk aplikasi. Semua penyimpanan data konektor yang ditambahkan ke aplikasi akan ditambahkan ke mesin ini.

ClientCertificateSettings

Setelan untuk sertifikat klien kustom.

Representasi JSON
{
  "tlsCertificate": string,
  "privateKey": string,
  "passphrase": string
}
Kolom
tlsCertificate

string

Wajib. Sertifikat TLS yang dienkode dalam format PEM. String ini harus menyertakan baris header awal dan footer akhir.

privateKey

string

Wajib. Nama resource versi secret SecretManager yang menyimpan kunci pribadi yang dienkode dalam format PEM. Format: projects/{project}/secrets/{secret}/versions/{version}

passphrase

string

Opsional. Nama resource versi rahasia SecretManager yang menyimpan frasa sandi untuk mendekripsi kunci pribadi. Harus dibiarkan tidak disetel jika kunci pribadi tidak dienkripsi. Format: projects/{project}/secrets/{secret}/versions/{version}

VpcScSettings

Setelan VPC-SC untuk aplikasi.

Representasi JSON
{
  "allowedOrigins": [
    string
  ]
}
Kolom
allowedOrigins[]

string

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.

EvaluationSettings

Setelan untuk evaluasi.

Representasi JSON
{
  "scenarioConversationInitiator": enum (EvaluationSettings.ScenarioConversationInitiator),
  "goldenRunMethod": enum (GoldenRunMethod),
  "goldenEvaluationToolCallBehaviour": enum (EvaluationToolCallBehaviour),
  "scenarioEvaluationToolCallBehaviour": enum (EvaluationToolCallBehaviour),
  "metricsConfig": {
    object (EvaluationMetricsConfig)
  },
  "scenarioExecutionMode": enum (EvaluationSettings.ScenarioExecutionMode),
  "evaluationRunCachingSettings": {
    object (EvaluationRunCachingSettings)
  }
}
Kolom
scenarioConversationInitiator

enum (EvaluationSettings.ScenarioConversationInitiator)

Opsional. Siapa yang memulai percakapan dalam evaluasi skenario.

goldenRunMethod

enum (GoldenRunMethod)

Opsional. Metode default yang digunakan untuk menjalankan evaluasi golden. Ini akan digunakan jika tidak ada goldenRunMethod yang ditentukan dalam RunEvaluationRequest.

goldenEvaluationToolCallBehaviour

enum (EvaluationToolCallBehaviour)

Opsional. Mengonfigurasi perilaku panggilan alat default untuk evaluasi emas.

scenarioEvaluationToolCallBehaviour

enum (EvaluationToolCallBehaviour)

Opsional. Mengonfigurasi perilaku panggilan alat default untuk evaluasi skenario.

metricsConfig

object (EvaluationMetricsConfig)

Opsional. Mengonfigurasi metrik default untuk evaluasi.

scenarioExecutionMode

enum (EvaluationSettings.ScenarioExecutionMode)

Opsional. Mode eksekusi untuk evaluasi skenario. Jika tidak diberikan, setelan defaultnya adalah QUALITY_OPTIMIZED.

evaluationRunCachingSettings

object (EvaluationRunCachingSettings)

Opsional. Setelan caching yang akan digunakan untuk operasi evaluasi.

EvaluationSettings.ScenarioConversationInitiator

Menentukan siapa yang memulai percakapan dalam sesi evaluasi skenario.

Enum
SCENARIO_CONVERSATION_INITIATOR_UNSPECIFIED Tidak ditentukan. Nilai defaultnya adalah USER.
USER Pengguna memulai percakapan.
AGENT Agen memulai percakapan.

DashboardSettings

Setelan untuk dasbor yang terkait dengan aplikasi, yang muncul di tampilan Monitoring.

Representasi JSON
{
  "defaultDashboard": string
}
Kolom
defaultDashboard

string

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: projects/{project}/locations/{location}/dashboards/{dashboard}

Metode

chatAiAssistant

Menjalankan Arc, asisten AI, untuk sesi asisten yang ditentukan.

create

Membuat aplikasi baru di project dan lokasi tertentu.

delete

Menghapus aplikasi yang ditentukan.

executeTool

Menjalankan alat yang diberikan dengan argumen yang diberikan.

exportApp

Mengekspor aplikasi yang ditentukan.

generateAppResource

Membuat resource tertentu (misalnya,

generateOnboardingSuggestions

Membuat saran orientasi yang dipersonalisasi untuk status nol Arc: mengklasifikasikan pengguna yang meminta (baru/menjelajah/kembali) dari histori sesi asisten mereka di aplikasi dan menampilkan chip saran (melanjutkan sesi, melanjutkan pekerjaan, atau memulai sesuatu yang baru) untuk dirender sebelum pesan dikirim.

get

Mendapatkan detail aplikasi yang ditentukan.

getExtendedAgentCard

Mendapatkan kartu agen yang diperluas untuk agen yang diautentikasi.

importApp

Mengimpor aplikasi yang ditentukan.

importEvaluations

Mengimpor evaluasi ke dalam aplikasi.

list

Mencantumkan aplikasi di project dan lokasi tertentu.

patch

Memperbarui aplikasi yang ditentukan.

retrieveToolSchema

Mengambil skema alat yang diberikan.

runAssistant

Menjalankan agen asisten untuk sesi asisten yang ditentukan.

runEvaluation

Menjalankan evaluasi aplikasi.

testPersonaVoice

Menguji suara persona.