API 연결

모든 HTTP API를 대화 중 에이전트가 호출할 수 있는 함수로 전환합니다. cURL 명령을 붙여넣으면 마법사가 도구 정의, 매개변수, 인증을 생성합니다.

API 연결은 에이전트가 대화 중 호출할 수 있는 맞춤형 HTTP 함수입니다. 주문을 조회하거나, 티켓을 생성하거나, 자체 백엔드에서 계정 상태를 가져올 수 있습니다. 엔드포인트는 연결 → API (/dashboard/api-connections)에서 한 번만 정의하면 됩니다. 연결이 추가된 에이전트는 대화 상황에 따라 언제든 이를 호출할 수 있습니다.

생성 방법은 두 가지입니다. 마법사가 분석할 수 있는 내용을 붙여넣거나, 연결을 수동으로 설정할 수 있습니다.

빠른 방법: 붙여넣고 분석하기

새 API 연결을 클릭합니다
대화 상자가 마법사에서 열립니다. 샘플 cURL 명령어, OpenAPI/Swagger 사양, Postman 내보내기, TypeScript 인터페이스 또는 Zod 스키마를 입력란에 붙여넣습니다.
분석을 클릭합니다
ThunderPhone이 붙여넣은 내용에서 URL, 메서드, 헤더와 발견한 쿼리 매개변수 및 요청 본문을 기반으로 한 매개변수 스키마를 포함한 전체 연결을 추론합니다. 인증 헤더를 포함해 붙여넣은 헤더는 엔드포인트 구성으로 전달됩니다.
강조 표시된 필드를 확인합니다
추론된 구성은 검토할 수 있도록 추정된 필드가 강조 표시된 상태로 열립니다. 에이전트가 함수를 언제 어떻게 호출해야 하는지 이해할 수 있도록 이름, 설명, 매개변수 유형을 조정합니다. 모델은 설명을 읽습니다.
검증 및 저장
저장하면 먼저 엔드포인트에 대해 실제 테스트 요청을 실행합니다. 요청이 실패하면 연결은 저장되지 않습니다. URL, 인증 헤더 또는 본문을 수정한 후 다시 시도합니다. 성공하면 연결은 검증됨 배지와 함께 저장됩니다.

마법사가 붙여넣은 내용에서 요청 URL을 찾지 못하면 이를 알려줍니다. 전체 http(s) 엔드포인트를 포함한 후 다시 시도합니다.

수동 설정

마법사에서 수동으로 설정 → 버튼을 클릭합니다. 또는 돌아가려면 AI가 이를 추론하도록 할까요? 마법사 사용 → 버튼을 클릭합니다. 수동 빌더에는 두 개의 편집기가 있습니다.

시각적 편집기 — 표시 이름, 함수 이름, 요청 URL, 메서드 (POST, GET, PUT, PATCH, DELETE), 맞춤 헤더, 매개변수 스키마를 위한 양식 필드입니다. 에이전트가 제공할 수 있는 각 인수에 대해 속성 추가를 사용합니다.
JSON — 도구 사양을 직접 붙여넣거나 세부 조정할 수 있는 원시 JSON 형식의 동일한 정의입니다.

선택 사항인 테스트 요청 패널에서 저장 전에 구성된 요청을 실행하고 상태, 지연 시간, 응답 미리보기를 확인할 수 있습니다. 검증 및 저장은 항상 이 테스트를 실행하며 성공한 경우에만 저장합니다.

연결 관리

각 연결 행에는 검증 상태인 검증됨, 테스트되지 않음 또는 오류, 함수 이름 및 이를 사용하는 에이전트가 표시됩니다. 행의 작업 메뉴에서 다음을 수행할 수 있습니다.

편집 — 구성을 다시 엽니다.
복제 — 시작점으로 사용할 수 있도록 복제합니다. 복사본은 테스트되지 않은 상태로 시작합니다.
수정 기록 — 이전 버전을 확인하고 하나를 편집기로 복원합니다.
전송 — 소속된 다른 조직으로 연결을 복사하거나 이동합니다. 이동하면 여기에서 제거되며, 이를 사용하던 에이전트는 재구성이 필요할 수 있습니다.
삭제 — 영구적으로 삭제합니다. 연결을 사용하는 에이전트는 재구성해야 합니다.