REST Resource: projects.locations.conversations

리소스: Conversation

대화 메시지입니다.

JSON 표현
{
  "name": string,
  "agents": [
    string
  ],
  "createTime": string,
  "lastUsedTime": string,
  "labels": {
    string: string,
    ...
  }
}
필드
name

string

선택사항. 식별자. 대화의 고유 리소스 이름입니다. 형식: projects/{project}/locations/{location}/conversations/{conversationId} {conversationId}은 리소스 ID이며 63자 이하여야 하고 https://google.aip.dev/122#resource-id-segments에 설명된 형식과 일치해야 합니다.

예: projects/1234567890/locations/us-central1/conversations/my-conversation

이 필드는 자동으로 추론되고 {parent}/conversations/{conversationId}로 덮어쓰이므로 대화 생성 중에 이 필드를 설정하지 않는 것이 좋습니다.

agents[]

string

필수 입력란입니다. 대화의 에이전트입니다. 현재는 하나의 에이전트만 지원됩니다. 이 필드는 향후 대화에서 여러 에이전트를 지원하기 위해 반복됩니다. 형식: projects/{project}/locations/{location}/dataAgents/{agent}

createTime

string (Timestamp format)

출력 전용입니다. 생성 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

lastUsedTime

string (Timestamp format)

출력 전용입니다. 마지막으로 사용한 대화의 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

labels

map (key: string, value: string)

선택사항입니다. 클라이언트가 대화에 태그를 지정하기 위해 설정할 수 있는 개방형 사용자 정의 라벨입니다 (예: 특정 표시 경로/제품의 대화를 필터링).

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

메서드

create

대화 기록을 유지하기 위해 새 대화를 만듭니다.

get

대화 ID와 상위를 사용하여 단일 대화의 세부정보를 가져옵니다.

list

지정된 상위 항목의 모든 대화를 나열합니다.