Method: projects.locations.apps.generateAppResource

Génère des ressources spécifiques (par exemple, un agent) dans l'application à l'aide de l'assistant LLM.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource de l'application pour laquelle générer la ressource.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
refineInstructions[]

object (GenerateAppResourceRequest.RefineInstructions)

Facultatif. Liste des instructions d'affinage à utiliser pour affiner la ressource.
toolGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig)

Facultatif. Configuration à utiliser pour générer l'outil.
appGenerationConfig

object (GenerateAppResourceRequest.AppGenerationConfig)

Facultatif. Configuration à utiliser pour générer les agents et les outils.
evaluationGenerationConfig

object (GenerateAppResourceRequest.EvaluationGenerationConfig)

Facultatif. Configuration à utiliser pour générer les évaluations.
evaluationPersonasGenerationConfig

object (GenerateAppResourceRequest.EvaluationPersonasGenerationConfig)

Facultatif. Configuration à utiliser pour générer les personas d'évaluation.
qualityReportGenerationConfig

object (GenerateAppResourceRequest.QualityReportGenerationConfig)

Facultatif. Configuration à utiliser pour générer des rapports sur la qualité.
hillClimbingFixConfig

object (GenerateAppResourceRequest.HillClimbingFixConfig)

Facultatif. Configuration à utiliser pour les corrections par escalade.
Ressource à générer. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
agent

object (Agent)

Ressource d'agent à utiliser par l'assistant LLM. Peut être vide pour générer un nouvel agent.
tool

object (Tool)

Ressource d'outil à utiliser par l'assistant LLM. Peut être vide pour générer un nouvel outil.
toolset

object (Toolset)

Ressource Toolset à utiliser par l'assistant LLM. Peut être vide pour générer un Toolset.
appVersionContext

object (GenerateAppResourceRequest.AppVersionContext)

Contexte de la version de l'application spécifiant l'instantané de base et l'agent cible.
Fin des champs qui s'excluent mutuellement.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • ces.apps.update

Pour en savoir plus, consultez la documentation IAM.

GenerateAppResourceRequest.AppVersionContext

Contexte de la version de l'application spécifiant l'instantané de base et l'agent cible.

Représentation JSON 
{
  "appVersion": string,
  "agentResourceName": string
}
Champs
appVersion

string

Nom de ressource de la version de l'application à utiliser par l'assistant LLM. Format : projects/{project}/locations/{location}/apps/{app}/versions/{version}
agentResourceName

string

Nom de ressource de l'agent cible à utiliser par l'assistant LLM. Format : projects/{project}/locations/{location}/apps/{app}/agents/{agent}

GenerateAppResourceRequest.RefineInstructions

Instructions à utiliser pour affiner une partie de la ressource. La partie de la ressource peut être spécifiée avec un index de début, un index de fin et un masque de champ. Par exemple, si vous souhaitez affiner une partie des instructions de l'agent, vous pouvez spécifier l'index du premier caractère des instructions, l'index du dernier caractère des instructions et le masque de champ en tant qu'"instructions".

Représentation JSON 
{
  "startIndex": string,
  "endIndex": string,
  "fieldMask": string,
  "instructions": string
}
Champs
startIndex

string (int64 format)

Obligatoire. Premier caractère (inclus) du texte à affiner.
endIndex

string (int64 format)

Obligatoire. Dernier caractère (inclus) du texte à affiner.
fieldMask

string (FieldMask format)

Obligatoire. Champ de la ressource affinée. Une seule instruction est autorisée par RefineInstructions. Si vous affinez les instructions de l'agent, le masque de champ doit être "instructions".

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".
instructions

string

Obligatoire. Instructions pour affiner la ressource.

GenerateAppResourceRequest.ToolGenerationConfig

Configuration à utiliser pour générer un outil.

Représentation JSON 
{
  "context": string,
  "fileContexts": [
    {
      object (FileContext)
    }
  ],
  "openApiToolsetGenerationConfig": {
    object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)
  }
}
Champs
context

string

Facultatif. Contexte décrivant l'outil à générer. Cette valeur peut être vide si la demande et la réponse de l'outil sont fournies.
fileContexts[]

object (FileContext)

Facultatif. Fichiers à utiliser comme contexte.
openApiToolsetGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)

Facultatif. Configuration à utiliser pour générer un schéma OpenAPI.

FileContext

Fichiers à utiliser comme contexte. Les fichiers peuvent être fournis sous forme d'octets bruts.

Représentation 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.
}
Champs
Fichier fourni comme contexte. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
fileBytes

object (FileContext.FileBytes)

Facultatif. Fichier fourni sous forme d'octets bruts.
Fin des champs qui s'excluent mutuellement.

FileContext.FileBytes

Fichier fourni sous forme d'octets bruts.

Représentation JSON 
{
  "fileName": string,
  "mimeType": string,
  "data": string
}
Champs
fileName

string

Obligatoire. Nom du fichier fourni sous forme d'octets bruts.
mimeType

string

Obligatoire. Type MIME standard IANA des données sources.
data

string (bytes format)

Obligatoire. Octets bruts du fichier.

Chaîne encodée en base64.

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig

Configuration à utiliser pour générer un schéma OpenAPI.

Représentation JSON 
{
  "uri": string,
  "operationGenerationConfigs": [
    {
      object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)
    }
  ]
}
Champs
uri

string

Obligatoire. URI de base de l'outil.
operationGenerationConfigs[]

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)

Obligatoire. Liste des opérations à ajouter au schéma Open API.

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig

Configuration à utiliser pour générer une opération dans le schéma OpenAPI.

Représentation JSON 
{
  "method": string,
  "path": string,
  "requestJson": string,
  "responseJson": string
}
Champs
method

string

Obligatoire. URI de l'outil. Cela doit inclure les paramètres de requête et de chemin d'accès, le cas échéant.
path

string

Obligatoire. Chemin d'accès à l'outil à ajouter à l'URI de base. Cela doit inclure les paramètres de requête et de chemin d'accès, le cas échéant.
requestJson

string

Obligatoire. Exemple de requête envoyée à l'outil au format JSON. Ignorez cette étape si l'outil ne prend pas en charge le corps de la requête.
responseJson

string

Obligatoire. Exemple de réponse de l'outil au format JSON.

GenerateAppResourceRequest.AppGenerationConfig

Configuration à utiliser pour générer l'application.

Représentation JSON 
{
  "context": string,
  "fileContexts": [
    {
      object (FileContext)
    }
  ],
  "datasetId": string,
  "generateEvaluations": boolean,
  "gcsLocation": string
}
Champs
context

string

Facultatif. Contexte décrivant les exigences des agents et des outils à générer.
fileContexts[]

object (FileContext)

Facultatif. Fichiers à utiliser comme contexte.
datasetId

string

Facultatif. Ensemble de données d'insights à utiliser pour extraire les données de conversation permettant de générer les agents et les outils. Format : projects/{project}/locations/{location}/datasets/{dataset}.
generateEvaluations

boolean

Facultatif. Indique si les évaluations de l'application doivent être générées. Si la valeur est "true", le contexte fourni sera utilisé pour générer les données d'évaluation.
gcsLocation

string

Facultatif. Emplacement Cloud Storage pour stocker les données de questions/réponses générées à utiliser par l'outil Datastore. Ces données ne sont générées que lorsque vous utilisez des données de conversation comme source d'entrée. L'emplacement doit se trouver dans le même projet que l'application. Format : gs://....

GenerateAppResourceRequest.EvaluationGenerationConfig

Configuration à utiliser pour générer les évaluations.

Représentation JSON 
{
  "datasetId": string
}
Champs
datasetId

string

Facultatif. Ensemble de données Insights à utiliser pour extraire les données de conversation et générer les évaluations. Format : projects/{project}/locations/{location}/datasets/{dataset}.

GenerateAppResourceRequest.EvaluationPersonasGenerationConfig

Ce type ne comporte aucun champ.

Configuration à utiliser pour générer les personas d'évaluation.

GenerateAppResourceRequest.QualityReportGenerationConfig

Configuration à utiliser pour générer des rapports sur la qualité.

Représentation JSON 
{
  "evaluationRun": string,
  "algorithm": enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)
}
Champs
evaluationRun

string

Obligatoire. Exécution de l'évaluation utilisée pour informer l'analyse du rapport sur la qualité.
algorithm

enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)

Facultatif. Algorithme d'attribution des pertes à utiliser.

GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm

Algorithme à utiliser pour l'attribution des pertes.

Enums
LOSS_ATTRIBUTION_ALGORITHM_UNSPECIFIED Non spécifié.
APP_CENTRIC Attribution des pertes axée sur les applications. Traite l'application comme une seule unité.
AGENT_CENTRIC Attribution des pertes centrée sur l'agent. Attribue la perte à des agents individuels.

GenerateAppResourceRequest.HillClimbingFixConfig

Configuration à utiliser pour les corrections par escalade.

Représentation JSON 
{
  "qualityReport": {
    object (QualityReport)
  }
}
Champs
qualityReport

object (QualityReport)

Obligatoire. Rapport sur la qualité utilisé pour informer la correction du suivi des instructions.

QualityReport

Rapport décrivant les problèmes de qualité identifiés dans l'application.

Représentation JSON 
{
  "issues": [
    {
      object (QualityReport.AgentIssues)
    }
  ],
  "evaluationRuns": [
    string
  ],
  "generalIssues": [
    {
      object (QualityReport.Issue)
    }
  ]
}
Champs
issues[]

object (QualityReport.AgentIssues)

Facultatif. Problèmes regroupés par agent.
evaluationRuns[]

string

Facultatif. Liste des exécutions d'évaluation utilisées pour générer le rapport sur la qualité. Format : projects/{project}/locations/{location}/evaluationRuns/{evaluationRun}.
generalIssues[]

object (QualityReport.Issue)

Facultatif. Problèmes généraux non spécifiques à un agent.

QualityReport.AgentIssues

Problèmes identifiés pour un seul agent.

Représentation JSON 
{
  "agent": string,
  "issues": [
    {
      object (QualityReport.Issue)
    }
  ]
}
Champs
agent

string

Facultatif. Nom de l'agent auquel les problèmes sont associés. Format : projects/{project}/locations/{location}/apps/{app}/agents/{agent}
issues[]

object (QualityReport.Issue)

Facultatif. Liste des problèmes détectés pour cet agent.

QualityReport.Issue

Le problème identifié.

Représentation JSON 
{
  "description": string,
  "occurrenceCount": integer,
  "proposedSolution": string
}
Champs
description

string

Facultatif. Description du problème détecté.
occurrenceCount

integer

Facultatif. Nombre de fois où ce problème s'est produit.
proposedSolution

string

Facultatif. Solution proposée pour résoudre le problème en modifiant les instructions ou les outils.