챗봇 버전(AgentVersion) API (V2)

AgentVersion은 AIP 챗봇의 버전 정보입니다. API의 Agent 명칭은 현재 챗봇 제품과의 호환 용어로 유지됩니다.

필드	자료형과 의미
`string`	필수 string, `majorVersion.minorVersion` 형식
`version.major`	필수 integer, 게시할 때마다 증가
`version.minor`	필수 integer, 저장할 때마다 증가

예를 들어 1.0의 구성 요소는 major=1, minor=0입니다. 게시와 저장은 서로 다른 버전 변경 계기입니다.

조회 API

List Agent Versions는 최근 버전부터 내림차순으로 반환합니다. 첫 요청에는 페이지 토큰을 넣지 않고 다음 요청에 응답의 nextPageToken을 사용합니다.

Get Agent Version은 Agent RID와 버전 문자열로 한 버전의 구성 요소를 조회합니다. 챗봇 표시 정보와 변수 정의가 필요하면 Get Agent에 버전을 지정합니다.

Get Agent의 버전을 생략하면 최신 게시 버전을 선택합니다. 버전 문자열은 두 부분 형식을 따르며, 잘못된 형식과 존재하지 않는 버전은 각각 해당 오류 계약에 따라 처리합니다.

이 두 버전 API는 api:aip-agents-read OAuth 권한 범위를 요청합니다. 미리보기 기능으로 preview=true가 필요하며 언제든 변경되거나 제거될 수 있습니다.