REST Resource: projects.locations.collections.engines.assistants.cannedQueries

리소스: CannedQuery

Assistant의 미리 준비된 쿼리 리소스입니다. 미리 정의된 대화 시작으로 연결되는 바로가기를 나타냅니다.

JSON 표현
{
  "name": string,
  "displayName": string,
  "defaultTexts": {
    object (CannedQueryTexts)
  },
  "localizedTexts": {
    string: {
      object (CannedQueryTexts)
    },
    ...
  },
  "requiredCapabilities": [
    {
      object (AssistantCapability)
    }
  ],
  "enabled": boolean,
  "googleDefined": boolean
}
필드
name

string

변경할 수 없습니다. 저장된 질문의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/cannedQueries/{cannedQuery}

길이 제한이 1,024자(영문 기준)인 UTF-8로 인코딩된 문자열이어야 합니다.

displayName

string

저장된 쿼리의 표시 이름입니다. 길이 제한이 128자(영문 기준)인 UTF-8로 인코딩된 문자열이어야 합니다.

defaultTexts

object (CannedQueryTexts)

필수 항목입니다. 텍스트 속성의 기본값 (현지화되지 않음)입니다.

localizedTexts

map (key: string, value: object (CannedQueryTexts))

(선택사항) 텍스트 속성의 번역입니다. 키는 BCP-47 언어 코드여야 합니다.

requiredCapabilities[]

object (AssistantCapability)

(선택사항) 이 미리 작성된 질문을 사용하기 위해 어시스턴트가 갖춰야 하는 기능입니다.

enabled

boolean

이 사전 정의된 질문이 사용 설정되었는지 여부입니다.

googleDefined

boolean

출력 전용입니다. Google에서 정의한 읽기 전용 사전 정의된 쿼리인지 여부입니다.

CannedQueryTexts

현지화할 수 있는 미리 작성된 질문의 텍스트 부분입니다.

JSON 표현
{
  "title": string,
  "prefix": string,
  "suggestedPrompts": [
    {
      object (SuggestedPrompt)
    }
  ]
}
필드
title

string

필수 항목입니다. 최종 사용자를 위한 제목입니다.

prefix

string

(선택사항) suggestedPrompts가 시작해야 하는 접두사입니다.

suggestedPrompts[]

object (SuggestedPrompt)

필수 항목입니다. 사용자에게 제공할 사전 설정된 질문의 프롬프트입니다.

SuggestedPrompt

사전 제작된 질문에 대한 추천 프롬프트입니다.

JSON 표현
{
  "promptText": string
}
필드
promptText

string

필수 항목입니다. 추천 프롬프트의 텍스트입니다.

AssistantCapability

이 미리 준비된 질문을 사용하는 데 필요한 어시스턴트 기능입니다.

JSON 표현
{

  // Union field capability can be only one of the following:
  "actionName": string
  // End of list of possible types for union field capability.
}
필드
통합 필드 capability. 어시스턴트의 기능입니다(작업 또는 도구). capability은 다음 중 하나여야 합니다.
actionName

string

이 미리 작성된 쿼리를 사용하기 위해 어시스턴트가 설정해야 하는 작업의 이름입니다.

메서드

create

CannedQuery를 만듭니다.

delete

CannedQuery를 삭제합니다.

get

CannedQuery을 가져옵니다.

list

Assistant 아래의 모든 CannedQuery를 나열합니다.

listActiveCannedQueryUserViews

모든 활성 CannedQueryCannedQueryUserView를 나열합니다.

patch

CannedQuery를 업데이트합니다.