Method: projects.locations.apps.generateAppResource

Membuat resource tertentu (misalnya, agen) di aplikasi menggunakan asisten LLM.

Permintaan HTTP

POST https://ces.googleapis.com/v1beta/{parent=projects/*/locations/*/apps/*}:generateAppResource

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nama resource aplikasi untuk membuat resource.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "refineInstructions": [
    {
      object (GenerateAppResourceRequest.RefineInstructions)
    }
  ],
  "toolGenerationConfig": {
    object (GenerateAppResourceRequest.ToolGenerationConfig)
  },
  "appGenerationConfig": {
    object (GenerateAppResourceRequest.AppGenerationConfig)
  },
  "evaluationGenerationConfig": {
    object (GenerateAppResourceRequest.EvaluationGenerationConfig)
  },
  "evaluationPersonasGenerationConfig": {
    object (GenerateAppResourceRequest.EvaluationPersonasGenerationConfig)
  },
  "qualityReportGenerationConfig": {
    object (GenerateAppResourceRequest.QualityReportGenerationConfig)
  },
  "hillClimbingFixConfig": {
    object (GenerateAppResourceRequest.HillClimbingFixConfig)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "agent": {
    object (Agent)
  },
  "tool": {
    object (Tool)
  },
  "toolset": {
    object (Toolset)
  },
  "appVersionContext": {
    object (GenerateAppResourceRequest.AppVersionContext)
  }
  // End of mutually exclusive fields.
}
Kolom
refineInstructions[]

object (GenerateAppResourceRequest.RefineInstructions)

Opsional. Daftar petunjuk penyempurnaan yang akan digunakan untuk menyempurnakan resource.
toolGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig)

Opsional. Konfigurasi yang akan digunakan untuk membuat alat.
appGenerationConfig

object (GenerateAppResourceRequest.AppGenerationConfig)

Opsional. Konfigurasi yang akan digunakan untuk membuat agen dan alat.
evaluationGenerationConfig

object (GenerateAppResourceRequest.EvaluationGenerationConfig)

Opsional. Konfigurasi yang akan digunakan untuk membuat evaluasi.
evaluationPersonasGenerationConfig

object (GenerateAppResourceRequest.EvaluationPersonasGenerationConfig)

Opsional. Konfigurasi yang akan digunakan untuk membuat persona evaluasi.
qualityReportGenerationConfig

object (GenerateAppResourceRequest.QualityReportGenerationConfig)

Opsional. Konfigurasi yang akan digunakan untuk pembuatan laporan kualitas.
hillClimbingFixConfig

object (GenerateAppResourceRequest.HillClimbingFixConfig)

Opsional. Konfigurasi yang akan digunakan untuk perbaikan pendakian bukit.
Resource yang akan dibuat. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
agent

object (Agent)

Resource agen yang akan digunakan oleh asisten LLM, dapat dikosongkan untuk membuat agen baru.
tool

object (Tool)

Resource alat yang akan digunakan oleh asisten LLM, dapat kosong untuk membuat alat baru.
toolset

object (Toolset)

Resource toolset yang akan digunakan oleh asisten LLM, dapat kosong untuk membuat toolset baru.
appVersionContext

object (GenerateAppResourceRequest.AppVersionContext)

Konteks versi aplikasi yang menentukan snapshot dasar dan agen target.
Akhir kolom yang saling eksklusif.

Isi respons

Jika berhasil, isi respons akan memuat instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource parent:

  • ces.apps.update

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.

GenerateAppResourceRequest.AppVersionContext

Konteks versi aplikasi yang menentukan snapshot dasar dan agen target.

Representasi JSON 
{
  "appVersion": string,
  "agentResourceName": string
}
Kolom
appVersion

string

Nama resource versi aplikasi yang akan digunakan oleh asisten LLM. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version}
agentResourceName

string

Nama resource agen target yang akan digunakan oleh asisten LLM. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

GenerateAppResourceRequest.RefineInstructions

Petunjuk yang akan digunakan untuk menyempurnakan bagian resource. Bagian resource dapat ditentukan dengan indeks awal, indeks akhir, dan mask kolom. Misalnya, jika Anda ingin menyempurnakan bagian petunjuk agen, Anda dapat menentukan indeks karakter pertama petunjuk, indeks karakter terakhir petunjuk, dan mask kolom sebagai "instructions".

Representasi JSON 
{
  "startIndex": string,
  "endIndex": string,
  "fieldMask": string,
  "instructions": string
}
Kolom
startIndex

string (int64 format)

Wajib. Karakter pertama (inklusif) dari teks yang akan disempurnakan.
endIndex

string (int64 format)

Wajib. Karakter terakhir (inklusif) dari teks yang akan disempurnakan.
fieldMask

string (FieldMask format)

Wajib. Kolom resource yang disempurnakan. Hanya satu kolom yang diizinkan per RefineInstructions. Jika menyempurnakan petunjuk agen, mask kolom harus berupa "instructions".

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
instructions

string

Wajib. Petunjuk untuk menyaring resource.

GenerateAppResourceRequest.ToolGenerationConfig

Konfigurasi yang akan digunakan untuk membuat alat.

Representasi JSON 
{
  "context": string,
  "fileContexts": [
    {
      object (FileContext)
    }
  ],
  "openApiToolsetGenerationConfig": {
    object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)
  }
}
Kolom
context

string

Opsional. Konteks yang menjelaskan alat yang akan dibuat. Kolom ini dapat kosong jika permintaan & respons alat diberikan.
fileContexts[]

object (FileContext)

Opsional. File yang akan digunakan sebagai konteks.
openApiToolsetGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)

Opsional. Konfigurasi yang akan digunakan untuk membuat skema Open API.

FileContext

File yang akan digunakan sebagai konteks. File dapat diberikan sebagai byte mentah.

Representasi JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileBytes": {
    object (FileContext.FileBytes)
  }
  // End of mutually exclusive fields.
}
Kolom
File yang diberikan sebagai konteks. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
fileBytes

object (FileContext.FileBytes)

Opsional. File yang diberikan sebagai byte mentah.
Akhir kolom yang saling eksklusif.

FileContext.FileBytes

File yang diberikan sebagai byte mentah.

Representasi JSON 
{
  "fileName": string,
  "mimeType": string,
  "data": string
}
Kolom
fileName

string

Wajib. Nama file yang diberikan sebagai byte mentah.
mimeType

string

Wajib. Jenis MIME standar IANA dari data sumber.
data

string (bytes format)

Wajib. Byte mentah file.

String berenkode base64.

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig

Konfigurasi yang akan digunakan untuk membuat skema Open API.

Representasi JSON 
{
  "uri": string,
  "operationGenerationConfigs": [
    {
      object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)
    }
  ]
}
Kolom
uri

string

Wajib. URI dasar alat.
operationGenerationConfigs[]

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)

Wajib. Daftar operasi yang akan ditambahkan ke skema Open API.

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig

Konfigurasi yang akan digunakan untuk membuat operasi dalam skema Open API.

Representasi JSON 
{
  "method": string,
  "path": string,
  "requestJson": string,
  "responseJson": string
}
Kolom
method

string

Wajib. URI alat. Ini harus mencakup parameter kueri dan jalur jika ada.
path

string

Wajib. Jalur alat yang akan ditambahkan ke URI dasar. Ini harus mencakup parameter kueri dan jalur jika ada.
requestJson

string

Wajib. Contoh permintaan ke alat dalam format JSON. Lewati jika alat tidak mendukung isi permintaan.
responseJson

string

Wajib. Contoh respons dari alat dalam format JSON.

GenerateAppResourceRequest.AppGenerationConfig

Konfigurasi yang akan digunakan untuk membuat aplikasi.

Representasi JSON 
{
  "context": string,
  "fileContexts": [
    {
      object (FileContext)
    }
  ],
  "datasetId": string,
  "generateEvaluations": boolean,
  "gcsLocation": string
}
Kolom
context

string

Opsional. Konteks yang menjelaskan persyaratan agen & alat yang akan dibuat.
fileContexts[]

object (FileContext)

Opsional. File yang akan digunakan sebagai konteks.
datasetId

string

Opsional. Set data insight yang akan digunakan untuk mengambil data percakapan guna membuat agen & alat. Format: projects/{project}/locations/{location}/datasets/{dataset}.
generateEvaluations

boolean

Opsional. Apakah akan membuat evaluasi untuk aplikasi. Jika benar (true), konteks yang diberikan akan digunakan untuk membuat data evaluasi.
gcsLocation

string

Opsional. Lokasi Cloud Storage untuk menyimpan data jawaban pertanyaan yang dihasilkan untuk digunakan oleh alat Datastore. Data ini hanya dibuat saat menggunakan data percakapan sebagai sumber input. Lokasi harus berada dalam project yang sama dengan aplikasi. Format: gs://....

GenerateAppResourceRequest.EvaluationGenerationConfig

Konfigurasi yang akan digunakan untuk membuat evaluasi.

Representasi JSON 
{
  "datasetId": string
}
Kolom
datasetId

string

Opsional. Kumpulan data insight yang akan digunakan untuk mengambil data percakapan guna membuat evaluasi. Format: projects/{project}/locations/{location}/datasets/{dataset}.

GenerateAppResourceRequest.EvaluationPersonasGenerationConfig

Jenis ini tidak memiliki kolom.

Konfigurasi yang akan digunakan untuk membuat persona evaluasi.

GenerateAppResourceRequest.QualityReportGenerationConfig

Konfigurasi yang akan digunakan untuk pembuatan laporan kualitas.

Representasi JSON 
{
  "evaluationRun": string,
  "algorithm": enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)
}
Kolom
evaluationRun

string

Wajib. Eksekusi evaluasi yang digunakan untuk menginformasikan analisis laporan kualitas.
algorithm

enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)

Opsional. Algoritma atribusi kerugian yang akan digunakan.

GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm

Algoritma yang akan digunakan untuk atribusi kerugian.

Enum
LOSS_ATTRIBUTION_ALGORITHM_UNSPECIFIED Tidak ditentukan.
APP_CENTRIC Atribusi kerugian yang berpusat pada aplikasi. Memperlakukan aplikasi sebagai satu unit.
AGENT_CENTRIC Atribusi kerugian yang berfokus pada agen. Mengatribusikan kerugian kepada setiap agen.

GenerateAppResourceRequest.HillClimbingFixConfig

Konfigurasi yang akan digunakan untuk perbaikan pendakian bukit.

Representasi JSON 
{
  "qualityReport": {
    object (QualityReport)
  }
}
Kolom
qualityReport

object (QualityReport)

Wajib. Laporan kualitas yang digunakan untuk menginformasikan perbaikan mengikuti petunjuk.

QualityReport

Laporan yang menjelaskan masalah kualitas yang teridentifikasi dalam aplikasi.

Representasi JSON 
{
  "issues": [
    {
      object (QualityReport.AgentIssues)
    }
  ],
  "evaluationRuns": [
    string
  ],
  "generalIssues": [
    {
      object (QualityReport.Issue)
    }
  ]
}
Kolom
issues[]

object (QualityReport.AgentIssues)

Opsional. Masalah yang dikelompokkan menurut agen.
evaluationRuns[]

string

Opsional. Daftar proses evaluasi yang digunakan untuk membuat laporan kualitas. Format: projects/{project}/locations/{location}/evaluationRuns/{evaluationRun}.
generalIssues[]

object (QualityReport.Issue)

Opsional. Masalah umum yang tidak spesifik untuk agen tertentu.

QualityReport.AgentIssues

Masalah yang teridentifikasi untuk satu agen.

Representasi JSON 
{
  "agent": string,
  "issues": [
    {
      object (QualityReport.Issue)
    }
  ]
}
Kolom
agent

string

Opsional. Nama agen yang terkait dengan masalah. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
issues[]

object (QualityReport.Issue)

Opsional. Daftar masalah yang ditemukan untuk agen ini.

QualityReport.Issue

Masalah yang teridentifikasi.

Representasi JSON 
{
  "description": string,
  "occurrenceCount": integer,
  "proposedSolution": string
}
Kolom
description

string

Opsional. Deskripsi masalah yang ditemukan.
occurrenceCount

integer

Opsional. Berapa kali masalah ini terjadi.
proposedSolution

string

Opsional. Solusi yang diusulkan untuk memperbaiki masalah dengan mengubah petunjuk atau alat.