다크 모드
API 도구
API 도구는 외부 REST API의 엔드포인트를 도구로 등록해 AI 애플리케이션에서 사용할 수 있게 합니다. Console에서는 같은 Base URL과 인증 정보를 사용하는 도구를 하나의 그룹으로 관리합니다.
화면 예시
API 도구 그룹 등록
| 항목 | 설명 |
|---|---|
| 이름 | API 도구 그룹의 이름입니다. |
| 설명 | 도구 그룹의 용도입니다. |
| Base URL | 그룹에 속한 도구가 공통으로 사용하는 기본 URL입니다. |
| 공개 범위 | 전체, 그룹, 비공개 등 리소스 접근 범위입니다. |
| 인증 방식 | API 호출에 적용할 공통 인증 정보입니다. |
지원하는 인증 방식은 인증 없음, API Key, Bearer Token, Basic Auth, OAuth 2.0, Custom Header입니다. 선택한 방식에 따라 키 위치, 토큰, 계정 정보, OAuth URL 또는 사용자 지정 헤더를 입력합니다.
도구 추가
도구는 직접 입력하거나 OpenAPI 파일에서 가져올 수 있습니다.
| 방식 | 설정 항목 |
|---|---|
| 직접 추가 | 도구 이름, 설명, HTTP 메서드, Path, Path·Query·Header 파라미터, Request Body |
| OpenAPI 가져오기 | JSON, YAML 또는 YML 파일에서 엔드포인트를 읽어 여러 도구를 추가 |
각 파라미터에는 이름, 데이터 타입, 설명, 필수 여부와 기본값을 설정할 수 있습니다. 저장 전에 목록에서 도구 구성을 검토하고 필요하면 수정하거나 삭제하세요.
현재 제공 범위
API 도구 화면에는 별도의 실행 테스트 탭이 없습니다. 등록한 구성이 실제 애플리케이션에서 필요한 입력 스키마와 인증 정보를 갖췄는지 먼저 확인하세요.