Method: projects.locations.apps.generateAppResource

LLM 어시스턴트를 사용하여 앱에서 특정 리소스 (예: 에이전트)를 생성합니다.

HTTP 요청

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

URL은 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

리소스의 일부를 세부적으로 조정하는 데 사용되는 안내입니다. 리소스의 일부는 시작 색인, 종료 색인, 필드 마스크로 지정할 수 있습니다. 예를 들어 에이전트 요청 사항의 일부를 수정하려면 요청 사항의 첫 번째 문자 색인, 요청 사항의 마지막 문자 색인, 필드 마스크를 '요청 사항'으로 지정하면 됩니다.

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)

(선택사항) Open 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

Open 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

Open API 스키마에서 작업을 생성하는 데 사용되는 구성입니다.

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

(선택사항) 데이터 스토어 도구에서 사용할 생성된 질문 답변 데이터를 저장할 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

(선택사항) 안내 또는 도구를 수정하여 문제를 해결하기 위한 제안된 해결 방법입니다.