Method: projects.locations.apps.generateAppResource

Genera risorse specifiche (ad es. agenti) nell'app utilizzando l'assistente LLM.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa dell'app per cui generare la risorsa.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
refineInstructions[]

object (GenerateAppResourceRequest.RefineInstructions)

Facoltativo. Elenco delle istruzioni di perfezionamento da utilizzare per perfezionare la risorsa.
toolGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig)

Facoltativo. La configurazione da utilizzare per generare lo strumento.
appGenerationConfig

object (GenerateAppResourceRequest.AppGenerationConfig)

Facoltativo. La configurazione da utilizzare per generare gli agenti e gli strumenti.
evaluationGenerationConfig

object (GenerateAppResourceRequest.EvaluationGenerationConfig)

Facoltativo. La configurazione da utilizzare per generare le valutazioni.
evaluationPersonasGenerationConfig

object (GenerateAppResourceRequest.EvaluationPersonasGenerationConfig)

Facoltativo. La configurazione da utilizzare per generare le buyer persona di valutazione.
qualityReportGenerationConfig

object (GenerateAppResourceRequest.QualityReportGenerationConfig)

Facoltativo. La configurazione da utilizzare per la generazione del report sulla qualità.
hillClimbingFixConfig

object (GenerateAppResourceRequest.HillClimbingFixConfig)

Facoltativo. La configurazione da utilizzare per le correzioni di hill climbing.
La risorsa da generare. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
agent

object (Agent)

La risorsa agente da utilizzare per l'assistente LLM può essere vuota per generare un nuovo agente.
tool

object (Tool)

La risorsa dello strumento da utilizzare per l'assistente LLM può essere vuota per generare un nuovo strumento.
toolset

object (Toolset)

La risorsa del set di strumenti da utilizzare per l'assistente LLM può essere vuota per generare un nuovo set di strumenti.
appVersionContext

object (GenerateAppResourceRequest.AppVersionContext)

Il contesto della versione dell'app che specifica lo snapshot di base e l'agente di destinazione.
Fine dei campi che si escludono a vicenda.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • ces.apps.update

Per saperne di più, consulta la documentazione di IAM.

GenerateAppResourceRequest.AppVersionContext

Il contesto della versione dell'app che specifica lo snapshot di base e l'agente di destinazione.

Rappresentazione JSON 
{
  "appVersion": string,
  "agentResourceName": string
}
Campi
appVersion

string

Il nome della risorsa della versione dell'app da utilizzare con l'assistente LLM. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version}
agentResourceName

string

Il nome della risorsa dell'agente di destinazione da utilizzare con l'assistente LLM. Formato: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

GenerateAppResourceRequest.RefineInstructions

Le istruzioni da utilizzare per perfezionare una parte della risorsa. La parte della risorsa può essere specificata con un indice iniziale, un indice finale e una maschera di campo. Ad esempio, se vuoi perfezionare una parte delle istruzioni dell'agente, puoi specificare l'indice del primo carattere delle istruzioni, l'indice dell'ultimo carattere delle istruzioni e la maschera del campo come "instructions".

Rappresentazione JSON 
{
  "startIndex": string,
  "endIndex": string,
  "fieldMask": string,
  "instructions": string
}
Campi
startIndex

string (int64 format)

Obbligatorio. Il primo carattere (incluso) del testo da perfezionare.
endIndex

string (int64 format)

Obbligatorio. L'ultimo carattere (incluso) del testo da perfezionare.
fieldMask

string (FieldMask format)

Obbligatorio. Il campo della risorsa che viene perfezionato. È consentito un solo campo per RefineInstructions. Se perfezioni le istruzioni dell'agente, la maschera del campo deve essere "instructions".

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".
instructions

string

Obbligatorio. Le istruzioni per perfezionare la risorsa.

GenerateAppResourceRequest.ToolGenerationConfig

La configurazione da utilizzare per generare uno strumento.

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

string

Facoltativo. Il contesto che descrive lo strumento da generare. Può essere vuoto se vengono forniti la richiesta e la risposta dello strumento.
fileContexts[]

object (FileContext)

Facoltativo. I file da utilizzare come contesto.
openApiToolsetGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)

Facoltativo. La configurazione da utilizzare per generare uno schema Open API.

FileContext

File da utilizzare come contesto. I file possono essere forniti come byte non elaborati.

Rappresentazione 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.
}
Campi
File fornito come contesto. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
fileBytes

object (FileContext.FileBytes)

Facoltativo. File fornito come byte non elaborati.
Fine dei campi che si escludono a vicenda.

FileContext.FileBytes

File fornito come byte non elaborati.

Rappresentazione JSON 
{
  "fileName": string,
  "mimeType": string,
  "data": string
}
Campi
fileName

string

Obbligatorio. Il nome del file fornito come byte non elaborati.
mimeType

string

Obbligatorio. Il tipo MIME standard IANA dei dati di origine.
data

string (bytes format)

Obbligatorio. Byte non elaborati del file.

Una stringa con codifica in base64.

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig

La configurazione da utilizzare per generare uno schema Open API.

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

string

Obbligatorio. L'URI di base dello strumento.
operationGenerationConfigs[]

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)

Obbligatorio. L'elenco delle operazioni da aggiungere allo schema Open API.

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig

La configurazione da utilizzare per generare un'operazione nello schema OpenAPI.

Rappresentazione JSON 
{
  "method": string,
  "path": string,
  "requestJson": string,
  "responseJson": string
}
Campi
method

string

Obbligatorio. L'URI dello strumento. Se presenti, devono essere inclusi i parametri di query e di percorso.
path

string

Obbligatorio. Il percorso dello strumento da aggiungere all'URI di base. Se presenti, devono essere inclusi i parametri di query e di percorso.
requestJson

string

Obbligatorio. Una richiesta di esempio allo strumento in formato JSON. Ignora se lo strumento non supporta il corpo della richiesta.
responseJson

string

Obbligatorio. Una risposta di esempio dello strumento in formato JSON.

GenerateAppResourceRequest.AppGenerationConfig

La configurazione da utilizzare per generare l'app.

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

string

Facoltativo. Il contesto che descrive i requisiti degli agenti e degli strumenti da generare.
fileContexts[]

object (FileContext)

Facoltativo. I file da utilizzare come contesto.
datasetId

string

Facoltativo. Il set di dati sugli approfondimenti da utilizzare per recuperare i dati delle conversazioni per generare gli agenti e gli strumenti. Formato: projects/{project}/locations/{location}/datasets/{dataset}.
generateEvaluations

boolean

Facoltativo. Indica se generare le valutazioni per l'app. Se true, il contesto fornito verrà utilizzato per generare i dati delle valutazioni.
gcsLocation

string

Facoltativo. La posizione di Cloud Storage in cui archiviare i dati delle risposte alle domande generate da utilizzare con lo strumento Datastore. Questi dati vengono generati solo quando si utilizzano i dati delle conversazioni come sorgente di ingresso. La posizione deve trovarsi nello stesso progetto dell'app. Formato: gs://....

GenerateAppResourceRequest.EvaluationGenerationConfig

La configurazione da utilizzare per generare le valutazioni.

Rappresentazione JSON 
{
  "datasetId": string
}
Campi
datasetId

string

Facoltativo. Il set di dati di approfondimenti da utilizzare per recuperare i dati delle conversazioni per generare le valutazioni. Formato: projects/{project}/locations/{location}/datasets/{dataset}.

GenerateAppResourceRequest.EvaluationPersonasGenerationConfig

Questo tipo non contiene campi.

La configurazione da utilizzare per generare le buyer persona di valutazione.

GenerateAppResourceRequest.QualityReportGenerationConfig

La configurazione da utilizzare per la generazione del report sulla qualità.

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

string

Obbligatorio. L'esecuzione della valutazione utilizzata per informare l'analisi del report sulla qualità.
algorithm

enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)

Facoltativo. L'algoritmo di attribuzione della perdita da utilizzare.

GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm

L'algoritmo da utilizzare per l'attribuzione della perdita.

Enum
LOSS_ATTRIBUTION_ALGORITHM_UNSPECIFIED Non specificato.
APP_CENTRIC Attribuzione della perdita incentrata sulle app. Considera l'app come una singola unità.
AGENT_CENTRIC Attribuzione della perdita incentrata sull'agente. Perdita di attributi per singoli agenti.

GenerateAppResourceRequest.HillClimbingFixConfig

La configurazione da utilizzare per le correzioni di hill climbing.

Rappresentazione JSON 
{
  "qualityReport": {
    object (QualityReport)
  }
}
Campi
qualityReport

object (QualityReport)

Obbligatorio. Il report sulla qualità utilizzato per informare la correzione del rispetto delle istruzioni.

QualityReport

Il report che descrive eventuali problemi di qualità identificati nell'app.

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

object (QualityReport.AgentIssues)

Facoltativo. I problemi raggruppati per agente.
evaluationRuns[]

string

Facoltativo. Un elenco di esecuzioni di valutazione utilizzate per generare il report sulla qualità. Formato: projects/{project}/locations/{location}/evaluationRuns/{evaluationRun}.
generalIssues[]

object (QualityReport.Issue)

Facoltativo. Problemi generali non specifici di alcun agente.

QualityReport.AgentIssues

Problemi identificati per un singolo agente.

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

string

Facoltativo. Il nome dell'agente a cui sono correlati i problemi. Formato: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
issues[]

object (QualityReport.Issue)

Facoltativo. Elenco dei problemi riscontrati per questo agente.

QualityReport.Issue

Il problema identificato.

Rappresentazione JSON 
{
  "description": string,
  "occurrenceCount": integer,
  "proposedSolution": string
}
Campi
description

string

Facoltativo. Descrizione del problema riscontrato.
occurrenceCount

integer

Facoltativo. Il numero di volte in cui si è verificato il problema.
proposedSolution

string

Facoltativo. Soluzione proposta per risolvere il problema modificando le istruzioni o gli strumenti.