Method: projects.locations.apps.generateAppResource

Gera recursos específicos (por exemplo, um agente) no app usando o assistente de LLM.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso do app para gerar o recurso.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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.
}
Campos
refineInstructions[]

object (GenerateAppResourceRequest.RefineInstructions)

Opcional. Lista de instruções de refinamento a serem usadas para refinar o recurso.
toolGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig)

Opcional. A configuração a ser usada para gerar a ferramenta.
appGenerationConfig

object (GenerateAppResourceRequest.AppGenerationConfig)

Opcional. A configuração a ser usada para gerar os agentes e as ferramentas.
evaluationGenerationConfig

object (GenerateAppResourceRequest.EvaluationGenerationConfig)

Opcional. A configuração a ser usada para gerar as avaliações.
evaluationPersonasGenerationConfig

object (GenerateAppResourceRequest.EvaluationPersonasGenerationConfig)

Opcional. A configuração a ser usada para gerar os perfis de avaliação.
qualityReportGenerationConfig

object (GenerateAppResourceRequest.QualityReportGenerationConfig)

Opcional. A configuração a ser usada para a geração de relatórios de qualidade.
hillClimbingFixConfig

object (GenerateAppResourceRequest.HillClimbingFixConfig)

Opcional. A configuração a ser usada para correções de ascensão de colina.
O recurso a ser gerado. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
agent

object (Agent)

O recurso do agente a ser usado pelo assistente de LLM. Pode estar vazio para gerar um novo agente.
tool

object (Tool)

O recurso de ferramenta a ser usado pelo assistente de LLM. Pode estar vazio para gerar uma nova ferramenta.
toolset

object (Toolset)

O recurso do conjunto de ferramentas a ser usado pelo assistente de LLM. Pode estar vazio para gerar um novo conjunto de ferramentas.
appVersionContext

object (GenerateAppResourceRequest.AppVersionContext)

O contexto da versão do app que especifica o snapshot de base e o agente de destino.
Fim dos campos mutuamente exclusivos.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • ces.apps.update

Para mais informações, consulte a documentação do IAM.

GenerateAppResourceRequest.AppVersionContext

O contexto da versão do app que especifica o snapshot de base e o agente de destino.

Representação JSON 
{
  "appVersion": string,
  "agentResourceName": string
}
Campos
appVersion

string

O nome do recurso da versão do app a ser usada pelo assistente de LLM. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version}
agentResourceName

string

O nome do recurso do agente de destino a ser usado pelo assistente de LLM. Formato: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

GenerateAppResourceRequest.RefineInstructions

As instruções a serem usadas para refinar uma parte do recurso. A parte do recurso pode ser especificada com um índice inicial, um índice final e uma máscara de campo. Por exemplo, se você quiser refinar uma parte das instruções do agente, especifique o índice do primeiro caractere, o índice do último caractere e a máscara de campo como "instructions".

Representação JSON 
{
  "startIndex": string,
  "endIndex": string,
  "fieldMask": string,
  "instructions": string
}
Campos
startIndex

string (int64 format)

Obrigatório. O primeiro caractere (inclusive) do texto a ser refinado.
endIndex

string (int64 format)

Obrigatório. O último caractere (inclusive) do texto a ser refinado.
fieldMask

string (FieldMask format)

Obrigatório. O campo do recurso que está sendo refinado. Só é permitido um campo por RefineInstructions. Se você estiver refinando as instruções do agente, a máscara de campo será "instructions".

Uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
instructions

string

Obrigatório. As instruções para refinar o recurso.

GenerateAppResourceRequest.ToolGenerationConfig

A configuração a ser usada para gerar uma ferramenta.

Representação JSON 
{
  "context": string,
  "fileContexts": [
    {
      object (FileContext)
    }
  ],
  "openApiToolsetGenerationConfig": {
    object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)
  }
}
Campos
context

string

Opcional. O contexto que descreve a ferramenta a ser gerada. Pode ficar vazio se a solicitação e a resposta da ferramenta forem fornecidas.
fileContexts[]

object (FileContext)

Opcional. Os arquivos a serem usados como contexto.
openApiToolsetGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)

Opcional. A configuração a ser usada para gerar um esquema de API aberta.

FileContext

Arquivos a serem usados como contexto. Os arquivos podem ser fornecidos como bytes brutos.

Representação 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.
}
Campos
Arquivo fornecido como contexto. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
fileBytes

object (FileContext.FileBytes)

Opcional. Arquivo fornecido como bytes brutos.
Fim dos campos mutuamente exclusivos.

FileContext.FileBytes

Arquivo fornecido como bytes brutos.

Representação JSON 
{
  "fileName": string,
  "mimeType": string,
  "data": string
}
Campos
fileName

string

Obrigatório. O nome do arquivo fornecido como bytes brutos.
mimeType

string

Obrigatório. O tipo MIME padrão da IANA dos dados de origem.
data

string (bytes format)

Obrigatório. Bytes brutos do arquivo.

Uma string codificada em base64.

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig

A configuração a ser usada para gerar um esquema de API aberta.

Representação JSON 
{
  "uri": string,
  "operationGenerationConfigs": [
    {
      object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)
    }
  ]
}
Campos
uri

string

Obrigatório. O URI de base da ferramenta.
operationGenerationConfigs[]

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)

Obrigatório. A lista de operações a serem adicionadas ao esquema de API aberta.

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig

A configuração a ser usada para gerar uma operação no esquema da OpenAPI.

Representação JSON 
{
  "method": string,
  "path": string,
  "requestJson": string,
  "responseJson": string
}
Campos
method

string

Obrigatório. O URI da ferramenta. Isso inclui parâmetros de consulta e de caminho, se houver.
path

string

Obrigatório. O caminho da ferramenta a ser anexado ao URI de base. Isso inclui parâmetros de consulta e de caminho, se houver.
requestJson

string

Obrigatório. Um exemplo de solicitação para a ferramenta no formato JSON. Pule se a ferramenta não aceitar corpo de solicitação.
responseJson

string

Obrigatório. Um exemplo de resposta da ferramenta no formato JSON.

GenerateAppResourceRequest.AppGenerationConfig

A configuração a ser usada para gerar o app.

Representação JSON 
{
  "context": string,
  "fileContexts": [
    {
      object (FileContext)
    }
  ],
  "datasetId": string,
  "generateEvaluations": boolean,
  "gcsLocation": string
}
Campos
context

string

Opcional. O contexto que descreve os requisitos dos agentes e das ferramentas a serem gerados.
fileContexts[]

object (FileContext)

Opcional. Os arquivos a serem usados como contexto.
datasetId

string

Opcional. O conjunto de dados de insights a ser usado para buscar dados de conversas e gerar agentes e ferramentas. Formato: projects/{project}/locations/{location}/datasets/{dataset}.
generateEvaluations

boolean

Opcional. Se as avaliações do app serão geradas. Se for "true", o contexto fornecido será usado para gerar os dados de avaliação.
gcsLocation

string

Opcional. O local do Cloud Storage para armazenar os dados de resposta da pergunta gerados que serão usados pela ferramenta Datastore. Esses dados são gerados apenas quando os dados de conversa são usados como uma fonte de entrada. O local precisa estar no mesmo projeto do app. Formato: gs://....

GenerateAppResourceRequest.EvaluationGenerationConfig

A configuração a ser usada para gerar as avaliações.

Representação JSON 
{
  "datasetId": string
}
Campos
datasetId

string

Opcional. O conjunto de dados de insights a ser usado para buscar dados de conversa e gerar as avaliações. Formato: projects/{project}/locations/{location}/datasets/{dataset}.

GenerateAppResourceRequest.EvaluationPersonasGenerationConfig

Esse tipo não tem campos.

A configuração a ser usada para gerar os perfis de avaliação.

GenerateAppResourceRequest.QualityReportGenerationConfig

A configuração a ser usada para a geração de relatórios de qualidade.

Representação JSON 
{
  "evaluationRun": string,
  "algorithm": enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)
}
Campos
evaluationRun

string

Obrigatório. A execução de avaliação usada para informar a análise do relatório de qualidade.
algorithm

enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)

Opcional. O algoritmo de atribuição de perda a ser usado.

GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm

O algoritmo a ser usado para atribuição de perda.

Tipos enumerados
LOSS_ATTRIBUTION_ALGORITHM_UNSPECIFIED Não especificado.
APP_CENTRIC Atribuição de perda centrada no app. Trata o app como uma única unidade.
AGENT_CENTRIC Atribuição de perda centrada no agente. Atribui a perda a agentes individuais.

GenerateAppResourceRequest.HillClimbingFixConfig

A configuração a ser usada para correções de ascensão de colina.

Representação JSON 
{
  "qualityReport": {
    object (QualityReport)
  }
}
Campos
qualityReport

object (QualityReport)

Obrigatório. O relatório de qualidade usado para informar a correção de obediência às instruções.

QualityReport

O relatório que descreve os problemas de qualidade identificados no app.

Representação JSON 
{
  "issues": [
    {
      object (QualityReport.AgentIssues)
    }
  ],
  "evaluationRuns": [
    string
  ],
  "generalIssues": [
    {
      object (QualityReport.Issue)
    }
  ]
}
Campos
issues[]

object (QualityReport.AgentIssues)

Opcional. Os problemas agrupados por agente.
evaluationRuns[]

string

Opcional. Uma lista de execuções de avaliação usadas para gerar o relatório de qualidade. Formato: projects/{project}/locations/{location}/evaluationRuns/{evaluationRun}.
generalIssues[]

object (QualityReport.Issue)

Opcional. Problemas gerais não específicos de nenhum agente.

QualityReport.AgentIssues

Problemas identificados para um único agente.

Representação JSON 
{
  "agent": string,
  "issues": [
    {
      object (QualityReport.Issue)
    }
  ]
}
Campos
agent

string

Opcional. O nome do agente a que os problemas estão relacionados. Formato: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
issues[]

object (QualityReport.Issue)

Opcional. Lista de problemas encontrados para este agente.

QualityReport.Issue

O problema identificado.

Representação JSON 
{
  "description": string,
  "occurrenceCount": integer,
  "proposedSolution": string
}
Campos
description

string

Opcional. Descrição do problema encontrado.
occurrenceCount

integer

Opcional. Quantas vezes o problema ocorreu.
proposedSolution

string

Opcional. Solução proposta para corrigir o problema modificando instruções ou ferramentas.