Method: projects.locations.apps.generateAppResource

使用 LLM 助理在应用中生成特定资源（例如代理）。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要为其生成资源的应用的资源名称。

请求正文

请求正文中包含结构如下的数据：

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.
}
字段
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)

可选。用于爬山修复的配置。
要生成的资源。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
agent

object (Agent)

LLM 助理要使用的代理资源，可以为空以生成新的代理。
tool

object (Tool)

LLM 助理要使用的工具资源，可以为空以生成新工具。
toolset

object (Toolset)

LLM 助理要使用的工具集资源，可以为空以生成新的工具集。
appVersionContext

object (GenerateAppResourceRequest.AppVersionContext)

应用版本上下文，用于指定基本快照和目标代理。
互斥字段的结束。

响应正文

如果成功，则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • ces.apps.update

如需了解详情，请参阅 IAM 文档。

GenerateAppResourceRequest.AppVersionContext

应用版本上下文，用于指定基本快照和目标代理。

JSON 表示法 
{
  "appVersion": string,
  "agentResourceName": string
}
字段
appVersion

string

LLM 助理要使用的应用版本的资源名称。格式：projects/{project}/locations/{location}/apps/{app}/versions/{version}
agentResourceName

string

LLM 助理要使用的目标代理的资源名称。格式：projects/{project}/locations/{location}/apps/{app}/agents/{agent}

GenerateAppResourceRequest.RefineInstructions

用于细化资源一部分的指令。资源的部分内容可以通过起始索引、结束索引和字段掩码来指定。例如，如果您想优化部分代理指令，可以指定指令的第一个字符的索引、指令的最后一个字符的索引，并将字段掩码指定为“instructions”。

JSON 表示法 
{
  "startIndex": string,
  "endIndex": string,
  "fieldMask": string,
  "instructions": string
}
字段
startIndex

string (int64 format)

必需。要细化的文本的第一个字符（含）。
endIndex

string (int64 format)

必需。要优化的文本的最后一个字符（含）。
fieldMask

string (FieldMask format)

必需。要细化的资源的字段。每个 RefineInstructions 只能有一个字段。如果需要优化代理指令，字段掩码应为“instructions”。

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。
instructions

string

必需。用于优化资源的指令。

GenerateAppResourceRequest.ToolGenerationConfig

用于生成工具的配置。

JSON 表示法 
{
  "context": string,
  "fileContexts": [
    {
      object (FileContext)
    }
  ],
  "openApiToolsetGenerationConfig": {
    object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)
  }
}
字段
context

string

可选。描述要生成的工具的上下文。如果提供了工具请求和响应，则此字段可以为空。
fileContexts[]

object (FileContext)

可选。要用作上下文的文件。
openApiToolsetGenerationConfig

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig)

可选。用于生成开放 API 架构的配置。

FileContext

要用作上下文的文件。文件可以以原始字节的形式提供。

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.
}
字段
作为上下文提供的文件。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
fileBytes

object (FileContext.FileBytes)

可选。以原始字节形式提供的文件。
互斥字段的结束。

FileContext.FileBytes

以原始字节形式提供的文件。

JSON 表示法 
{
  "fileName": string,
  "mimeType": string,
  "data": string
}
字段
fileName

string

必需。以原始字节形式提供的文件的名称。
mimeType

string

必需。来源数据的 IANA 标准 MIME 类型。
data

string (bytes format)

必需。文件的原始字节。

使用 base64 编码的字符串。

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig

用于生成开放 API 架构的配置。

JSON 表示法 
{
  "uri": string,
  "operationGenerationConfigs": [
    {
      object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)
    }
  ]
}
字段
uri

string

必需。工具的基础 URI。
operationGenerationConfigs[]

object (GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig)

必需。要添加到 Open API 架构的操作列表。

GenerateAppResourceRequest.ToolGenerationConfig.OpenApiToolsetGenerationConfig.OperationGenerationConfig

用于在 OpenAPI schema 中生成操作的配置。

JSON 表示法 
{
  "method": string,
  "path": string,
  "requestJson": string,
  "responseJson": string
}
字段
method

string

必需。工具的 URI。应包含查询参数和路径参数（如有）。
path

string

必需。要附加到基本 URI 的工具的路径。应包含查询参数和路径参数（如有）。
requestJson

string

必需。以 JSON 格式向工具发送的示例请求。如果该工具不支持请求正文，则跳过。
responseJson

string

必需。该工具以 JSON 格式返回的示例响应。

GenerateAppResourceRequest.AppGenerationConfig

用于生成应用的配置。

JSON 表示法 
{
  "context": string,
  "fileContexts": [
    {
      object (FileContext)
    }
  ],
  "datasetId": string,
  "generateEvaluations": boolean,
  "gcsLocation": string
}
字段
context

string

可选。用于描述要生成的代理和工具的要求的上下文。
fileContexts[]

object (FileContext)

可选。要用作上下文的文件。
datasetId

string

可选。用于提取对话数据以生成代理和工具的分析数据集。格式：projects/{project}/locations/{location}/datasets/{dataset}。
generateEvaluations

boolean

可选。是否为应用生成评价。如果为 true，则提供的上下文将用于生成评价数据。
gcsLocation

string

可选。用于存储生成的问答数据（供 Datastore 工具使用）的 Cloud Storage 位置。仅当使用对话数据作为输入源时，才会生成此数据。位置必须与应用位于同一项目中。格式：gs://...。

GenerateAppResourceRequest.EvaluationGenerationConfig

用于生成评估的配置。

JSON 表示法 
{
  "datasetId": string
}
字段
datasetId

string

可选。用于提取对话数据以生成评估的分析洞见数据集。格式：projects/{project}/locations/{location}/datasets/{dataset}。

GenerateAppResourceRequest.EvaluationPersonasGenerationConfig

此类型没有字段。

用于生成评估角色的配置。

GenerateAppResourceRequest.QualityReportGenerationConfig

用于生成质量报告的配置。

JSON 表示法 
{
  "evaluationRun": string,
  "algorithm": enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)
}
字段
evaluationRun

string

必需。用于提供质量报告分析信息的评估运行。
algorithm

enum (GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm)

可选。要使用的损失归因算法。

GenerateAppResourceRequest.QualityReportGenerationConfig.LossAttributionAlgorithm

用于损失归因的算法。

枚举
LOSS_ATTRIBUTION_ALGORITHM_UNSPECIFIED 未指定。
APP_CENTRIC 以应用为中心的损失归因。将应用视为一个整体。
AGENT_CENTRIC 以智能体为中心的损失归因。将损失归因于各个代理。

GenerateAppResourceRequest.HillClimbingFixConfig

用于爬山修复的配置。

JSON 表示法 
{
  "qualityReport": {
    object (QualityReport)
  }
}
字段
qualityReport

object (QualityReport)

必需。用于在修复后提供相关说明的质量报告。

QualityReport

报告，其中描述了应用中发现的所有质量问题。

JSON 表示法 
{
  "issues": [
    {
      object (QualityReport.AgentIssues)
    }
  ],
  "evaluationRuns": [
    string
  ],
  "generalIssues": [
    {
      object (QualityReport.Issue)
    }
  ]
}
字段
issues[]

object (QualityReport.AgentIssues)

可选。按代理分组的问题。
evaluationRuns[]

string

可选。用于生成质量报告的评估运行列表。格式：projects/{project}/locations/{location}/evaluationRuns/{evaluationRun}。
generalIssues[]

object (QualityReport.Issue)

可选。不特定于任何代理的一般问题。

QualityReport.AgentIssues

针对单个代理发现的问题。

JSON 表示法 
{
  "agent": string,
  "issues": [
    {
      object (QualityReport.Issue)
    }
  ]
}
字段
agent

string

可选。问题所涉及的代理的名称。格式：projects/{project}/locations/{location}/apps/{app}/agents/{agent}
issues[]

object (QualityReport.Issue)

可选。相应代理的问题列表。

QualityReport.Issue

发现的问题。

JSON 表示法 
{
  "description": string,
  "occurrenceCount": integer,
  "proposedSolution": string
}
字段
description

string

可选。发现的问题的说明。
occurrenceCount

integer

可选。相应问题发生的次数。
proposedSolution

string

可选。通过修改指令或工具来解决问题的建议解决方案。