REST Resource: projects.locations.apps

Resource: App

Aplikasi berfungsi sebagai penampung tingkat atas untuk sekelompok agen, termasuk agen root dan sub-agennya, beserta konfigurasi terkaitnya. 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)
  },
  "locked": boolean
}
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 dalam 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. Menangani error setelan aplikasi.
modelSettings

object (ModelSettings)

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

enum (App.ToolExecutionMode)

Opsional. Mode eksekusi alat untuk aplikasi. Jika tidak diberikan, defaultnya adalah PARALLEL.
evaluationMetricsThresholds

object (EvaluationMetricsThresholds)

Opsional. Batas evaluasi untuk aplikasi.
variableDeclarations[]

object (App.VariableDeclaration)

Opsional. Deklarasi variabel.
predefinedVariableDeclarations[]

object (App.VariableDeclaration)

Hanya output. Deklarasi variabel standar 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 pembatasan 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 atau penggunaan yang dimaksudkan dari aplikasi.

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

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "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, pembaruan akan menimpa perubahan serentak.
deploymentCount

integer

Hanya output. Jumlah deployment di aplikasi.
clientCertificateSettings

object (ClientCertificateSettings)

Opsional. Setelan sertifikat klien default untuk aplikasi.
locked

boolean

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

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 benar (true), agen di aplikasi akan menggunakan petunjuk bawaan untuk meningkatkan penanganan input multibahasa.
fallbackAction

string

Opsional. 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 ditentukan sebelumnya, seperti "eskalasikan" atau "keluar", yang memicu sinyal EndSession dengan metadata yang sesuai untuk mengakhiri 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 tentang cara pemrosesan dan pengiriman audio input dan output.

Representasi JSON 
{
  "synthesizeSpeechConfigs": {
    string: {
      object (SynthesizeSpeechConfig)
    },
    ...
  },
  "bargeInConfig": {
    object (BargeInConfig)
  },
  "inactivityTimeout": string,
  "ambientSoundConfig": {
    object (AmbientSoundConfig)
  }
}
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", maka 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 interupsi pengguna.
inactivityTimeout

string (Duration format)

Opsional. Durasi tidak aktif 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, yang 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.

SynthesizeSpeechConfig

Konfigurasi cara sintesis respons agen.

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

string

Opsional. Nama suara. Jika tidak disetel, 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 setengah kali lebih cepat. Nilai di luar rentang [0,25, 2,0] akan menampilkan error.

BargeInConfig

Konfigurasi cara penanganan aktivitas interupsi pengguna.

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

boolean

Opsional. Menonaktifkan interupsi pengguna saat agen sedang berbicara. Jika benar (true), input pengguna selama pemutaran respons agen akan diabaikan.

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

boolean

Opsional. Jika diaktifkan, agen akan menyesuaikan respons berikutnya berdasarkan asumsi bahwa pengguna belum mendengar pesan agen sebelumnya secara keseluruhan. Tindakan 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,

  // Union field source can be only one of the following:
  "prebuiltAmbientNoise": enum (AmbientSoundConfig.PrebuiltAmbientNoise),
  "gcsUri": string,
  "prebuiltAmbientSound": string
  // End of list of possible types for union field source.
}
Kolom
volumeGainDb

number

Opsional. Peningkatan volume (dalam dB) volume native normal yang didukung oleh derau sekitar, dalam rentang [-96,0, 16,0]. Jika tidak disetel, atau disetel ke nilai 0,0 (dB), akan diputar pada amplitudo sinyal native normal. Nilai -6,0 (dB) akan diputar dengan sekitar setengah amplitudo sinyal native normal. Nilai +6,0 (dB) akan diputar dengan amplitudo sinyal native normal sekitar dua kali lipat. Sebaiknya jangan melebihi +10 (dB) karena biasanya tidak ada peningkatan keefektifan volume untuk nilai yang lebih besar dari itu.
Kolom union source. Suara sekitar yang akan diputar dengan respons agen yang disintesis, untuk meningkatkan kealamian percakapan. source hanya ada berupa salah satu diantara berikut:
prebuiltAmbientNoise
(deprecated)

enum (AmbientSoundConfig.PrebuiltAmbientNoise)

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

string

Opsional. Derau sekitar sebagai file WAV 16 kHz satu saluran 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"

AmbientSoundConfig.PrebuiltAmbientNoise

Suara bising di sekitar yang sudah dibuat sebelumnya.

Enum
PREBUILT_AMBIENT_NOISE_UNSPECIFIED Tidak ditentukan.
RETAIL_STORE Derau sekitar toko retail.
CONVENTION_HALL Suara bising di sekitar ruang konvensi.
OUTDOOR Suara bising di jalan.

LoggingSettings

Setelan untuk menjelaskan perilaku logging aplikasi.

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

object (RedactionConfig)

Opsional. Konfigurasi cara data sensitif harus disamarkan.
audioRecordingConfig

object (AudioRecordingConfig)

Opsional. Konfigurasi cara interaksi audio harus direkam.
bigqueryExportSettings

object (BigQueryExportSettings)

Opsional. Setelan untuk menjelaskan perilaku ekspor BigQuery untuk aplikasi. Data percakapan akan diekspor ke tabel BigQuery jika diaktifkan.
cloudLoggingSettings

object (CloudLoggingSettings)

Opsional. Setelan untuk menjelaskan perilaku Cloud Logging untuk aplikasi.
conversationLoggingSettings

object (ConversationLoggingSettings)

Opsional. Setelan untuk menjelaskan 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 menjelaskan perilaku pengumpulan data percakapan untuk pipeline analisis LLM untuk aplikasi.

RedactionConfig

Konfigurasi untuk menginstruksikan cara menangani data sensitif.

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

boolean

Opsional. Jika benar (true), penyamaran 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 cara merekam 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 dari aplikasi, Anda harus memberikan izin storage.objects.create ke 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 menjelaskan perilaku BigQuery Export untuk aplikasi.

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

boolean

Opsional. Menunjukkan apakah ekspor BigQuery diaktifkan.
project

string

Opsional. ID project set data BigQuery yang akan diekspor datanya.

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. Set data BigQuery tempat data akan diekspor.

CloudLoggingSettings

Setelan untuk menjelaskan perilaku Cloud Logging untuk aplikasi.

Representasi JSON 
{
  "enableCloudLogging": boolean
}
Kolom
enableCloudLogging

boolean

Opsional. Apakah akan mengaktifkan Cloud Logging untuk sesi.

ConversationLoggingSettings

Setelan untuk menjelaskan perilaku logging percakapan untuk aplikasi.

Representasi JSON 
{
  "disableConversationLogging": boolean
}
Kolom
disableConversationLogging

boolean

Opsional. Apakah akan menonaktifkan logging percakapan untuk sesi.

MetricAnalysisSettings

Setelan untuk menjelaskan 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 (true), 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)
}
Kolom
errorHandlingStrategy

enum (ErrorHandlingSettings.ErrorHandlingStrategy)

Opsional. Strategi yang akan digunakan untuk penanganan error.

ErrorHandlingSettings.ErrorHandlingStrategy

Menentukan strategi untuk menangani error.

Enum
ERROR_HANDLING_STRATEGY_UNSPECIFIED Strategi penanganan error tidak ditentukan. Defaultnya adalah FALLBACK_RESPONSE.
NONE Tidak ada penanganan khusus yang diaktifkan.
FALLBACK_RESPONSE Pesan pengganti akan ditampilkan kepada pengguna jika terjadi error LLM.

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. Nilai defaultnya adalah PARALEL.
PARALLEL Jika ada beberapa alat yang dipilih, alat tersebut akan dieksekusi secara paralel, dengan ToolContext yang sama.
SEQUENTIAL Jika ada beberapa alat yang dipilih, alat tersebut akan dijalankan secara berurutan. Alat berikutnya hanya akan dieksekusi setelah alat sebelumnya selesai dan dapat melihat ToolContext yang diperbarui dari alat sebelumnya.

EvaluationMetricsThresholds

Setelan nilai minimum untuk metrik dalam Evaluasi.

Representasi JSON 
{
  "goldenEvaluationMetricsThresholds": {
    object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds)
  },
  "hallucinationMetricBehavior": enum (EvaluationMetricsThresholds.HallucinationMetricBehavior),
  "goldenHallucinationMetricBehavior": enum (EvaluationMetricsThresholds.HallucinationMetricBehavior),
  "scenarioHallucinationMetricBehavior": enum (EvaluationMetricsThresholds.HallucinationMetricBehavior)
}
Kolom
goldenEvaluationMetricsThresholds

object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds)

Opsional. Nilai minimum metrik evaluasi emas.
hallucinationMetricBehavior
(deprecated)

enum (EvaluationMetricsThresholds.HallucinationMetricBehavior)

Opsional. Tidak digunakan lagi: Gunakan goldenHallucinationMetricBehavior sebagai gantinya. Perilaku metrik halusinasi saat ini digunakan untuk evaluasi utama.
goldenHallucinationMetricBehavior

enum (EvaluationMetricsThresholds.HallucinationMetricBehavior)

Opsional. Perilaku metrik halusinasi untuk evaluasi tepercaya.
scenarioHallucinationMetricBehavior

enum (EvaluationMetricsThresholds.HallucinationMetricBehavior)

Opsional. Perilaku metrik halusinasi untuk evaluasi skenario.

EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds

Setelan untuk evaluasi emas.

Representasi JSON 
{
  "turnLevelMetricsThresholds": {
    object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds)
  },
  "expectationLevelMetricsThresholds": {
    object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.ExpectationLevelMetricsThresholds)
  },
  "toolMatchingSettings": {
    object (EvaluationMetricsThresholds.ToolMatchingSettings)
  }
}
Kolom
turnLevelMetricsThresholds

object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds)

Opsional. Nilai minimum metrik tingkat perputaran.
expectationLevelMetricsThresholds

object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.ExpectationLevelMetricsThresholds)

Opsional. Nilai minimum metrik tingkat ekspektasi.
toolMatchingSettings

object (EvaluationMetricsThresholds.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 standar.

EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds

Mengaktifkan batas metrik tingkat perolehan.

Representasi JSON 
{
  "semanticSimilarityChannel": enum (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds.SemanticSimilarityChannel),
  "semanticSimilaritySuccessThreshold": integer,
  "overallToolInvocationCorrectnessThreshold": number
}
Kolom
semanticSimilarityChannel

enum (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds.SemanticSimilarityChannel)

Opsional. Saluran kemiripan semantik yang akan digunakan untuk evaluasi.
semanticSimilaritySuccessThreshold

integer

Opsional. Ambang batas keberhasilan untuk kemiripan semantik. Harus berupa bilangan bulat antara 0 dan 4. Defaultnya adalah >= 3.
overallToolInvocationCorrectnessThreshold

number

Opsional. Ambang batas keberhasilan untuk kebenaran pemanggilan alat secara keseluruhan. Harus berupa float antara 0 dan 1. Defaultnya adalah 1.0.

EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds.SemanticSimilarityChannel

Saluran kemiripan semantik yang akan digunakan.

Enum
SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED Metrik tidak ditentukan. Nilai defaultnya adalah TEXT.
TEXT Menggunakan kemiripan semantik teks.
AUDIO Gunakan kesamaan semantik audio.

EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.ExpectationLevelMetricsThresholds

Nilai minimum metrik tingkat ekspektasi.

Representasi JSON 
{
  "toolInvocationParameterCorrectnessThreshold": number
}
Kolom
toolInvocationParameterCorrectnessThreshold

number

Opsional. Ambang batas keberhasilan untuk kebenaran parameter pemanggilan alat individual. Harus berupa float antara 0 dan 1. Defaultnya adalah 1.0.

EvaluationMetricsThresholds.ToolMatchingSettings

Setelan untuk mencocokkan panggilan alat.

Representasi JSON 
{
  "extraToolCallBehavior": enum (EvaluationMetricsThresholds.ToolMatchingSettings.ExtraToolCallBehavior)
}
Kolom
extraToolCallBehavior

enum (EvaluationMetricsThresholds.ToolMatchingSettings.ExtraToolCallBehavior)

Opsional. Perilaku untuk panggilan alat tambahan. Nilai defaultnya adalah GAGAL.

EvaluationMetricsThresholds.ToolMatchingSettings.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 standar.

Enum
EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED Perilaku tidak ditentukan. Nilai defaultnya adalah GAGAL.
FAIL Gagal dalam evaluasi jika panggilan alat tambahan ditemukan.
ALLOW Izinkan panggilan alat tambahan.

EvaluationMetricsThresholds.HallucinationMetricBehavior

Perilaku metrik halusinasi. Terlepas dari perilakunya, metrik akan selalu dihitung. Perbedaannya adalah bahwa jika dinonaktifkan, metrik tidak digunakan untuk menghitung skor evaluasi keseluruhan.

Enum
HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED Perilaku metrik halusinasi tidak ditentukan.
DISABLED Nonaktifkan metrik halusinasi.
ENABLED Aktifkan metrik halusinasi.

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 rahasia 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}

Metode

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.

get

 Mendapatkan detail aplikasi yang ditentukan.

importApp

 Mengimpor aplikasi yang ditentukan.

list

 Mencantumkan aplikasi dalam project dan lokasi tertentu.

patch

 Memperbarui aplikasi yang ditentukan.

retrieveToolSchema

 Mengambil skema alat yang diberikan.