에이전트 목록

에이전트 및 해당 메타데이터 목록을 반환합니다.

헤더

xi-api-keystring선택 사항

쿼리 매개변수

page_sizeinteger선택 사항1-100기본값 30

반환할 최대 에이전트 수입니다. 100을 초과할 수 없으며 기본값은 30입니다.

searchstring or null선택 사항

에이전트 이름으로 검색합니다.

archivedboolean or null선택 사항기본값 false

보관 상태로 에이전트 필터링

show_only_owned_agentsboolean선택 사항기본값 falseDeprecated

true로 설정하면 엔드포인트는 다른 사용자가 공유한 에이전트를 제외하고 소유한 에이전트만 포함합니다. 더 이상 사용되지 않음: 대신 created_by_user_id를 사용하세요.

created_by_user_idstring or null선택 사항

생성자 사용자 ID로 에이전트를 필터링합니다. 설정하면 이 사용자가 생성한 에이전트만 반환됩니다. show_only_owned_agents보다 우선합니다. 인증된 사용자를 가리키려면 ‘@me’를 사용하세요.

tagslist of strings or null선택 사항

태그로 에이전트를 필터링합니다. 여러 태그 중 하나와 일치시키려면 매개변수를 반복하세요.

sort_directionenum선택 사항

결과 정렬 방향

허용된 값:
sort_byenum or null선택 사항

결과를 정렬할 필드

허용된 값:
cursorstring or null선택 사항

다음 페이지를 가져오는 데 사용됩니다. 응답에서 커서가 반환됩니다.

응답

성공 응답

agentslist of objects

에이전트 및 해당 메타데이터 목록입니다.

has_moreboolean

페이지네이션할 에이전트가 더 있는지 여부

next_cursorstring or null선택 사항

에이전트 페이지네이션에 사용할 다음 커서입니다.

오류

422
Unprocessable Entity Error