/dashboard/api-connections)에서 엔드포인트를 한 번 정의하면, 해당 연결이 연결된 에이전트가 대화 상황에 따라 이를 호출할 수 있습니다.
구축 방법은 두 가지입니다. 마법사가 분석할 수 있는 내용을 붙여넣거나, 연결을 수동으로 설정합니다.
빠른 방법: 붙여넣고 분석하기
1
새 API 연결을 클릭합니다
대화 상자가 마법사에서 열립니다. 상자에 샘플 cURL 명령어,
OpenAPI/Swagger 사양, Postman 내보내기, TypeScript
인터페이스 또는 Zod 스키마를 붙여넣습니다.
2
분석을 클릭합니다
ThunderPhone이 붙여넣은 내용에서 URL, 메서드, 헤더, 그리고 발견한
쿼리 매개변수와 요청 본문을 기반으로 한 매개변수 스키마를 포함한 전체 연결을 추론합니다.
인증 헤더를 포함하여 붙여넣은 헤더는 엔드포인트 구성으로 가져옵니다.
3
강조 표시된 필드를 확인합니다
추론된 구성은 검토할 수 있도록 추정된 필드가 강조 표시된 상태로 열립니다.
에이전트가 함수를 언제 어떻게 호출해야 하는지 이해할 수 있도록 이름, 설명, 매개변수 유형을 조정합니다.
모델은 설명을 읽습니다.
4
검증 및 저장
저장하면 먼저 엔드포인트에 대해 실제 테스트 요청을 실행합니다. 요청이 실패하면 연결은 저장되지 않습니다.
URL, 인증 헤더 또는 본문을 수정한 후 다시 시도합니다. 성공하면 연결이 검증됨 배지와 함께 저장됩니다.
http(s) 엔드포인트를 포함한 후 다시 시도합니다.
수동 설정
마법사에서 **수동으로 설정 →**을 클릭합니다(또는 돌아가려면 **AI가 이를 추론하도록 할까요? 마법사 사용 →**을 클릭합니다). 수동 빌더에는 두 가지 편집기가 있습니다.- 시각적 — 표시 이름, 함수 이름, 요청 URL, 메서드 (
POST,GET,PUT,PATCH,DELETE), 맞춤 헤더, 매개변수 스키마를 위한 양식 필드입니다(에이전트가 제공할 수 있는 각 인수에 속성 추가를 사용합니다). - JSON — 도구 사양을 직접 붙여넣거나 세부 조정할 수 있는 원시 JSON 형식의 동일한 정의입니다.
연결 관리
각 연결 행에는 검증 상태인 검증됨, 미테스트 또는 오류, 함수 이름 및 이를 사용하는 에이전트가 표시됩니다. 행의 작업 메뉴에서 다음을 수행할 수 있습니다.- 편집 — 구성을 다시 엽니다.
- 복제 — 시작점으로 사용할 수 있도록 복제합니다(복사본은 미테스트 상태로 시작합니다).
- 수정 이력 — 이전 버전을 보고 하나를 편집기로 복원합니다.
- 전송 — 소속된 다른 조직으로 연결을 복사하거나 이동합니다. 이동하면 여기에서 제거되며, 이를 사용하던 에이전트는 재구성이 필요할 수 있습니다.
- 삭제 — 영구적으로 삭제합니다. 연결을 사용하는 에이전트는 재구성해야 합니다.
에이전트에 연결하기
빌더의 API 연결 섹션에서 에이전트에 연결을 추가합니다 (에이전트 구축). 목록에는 각 연결을 사용하는 에이전트가 표시되므로 변경 사항이 무엇에 영향을 주는지 한눈에 확인할 수 있습니다.다음 단계
API를 통한 도구 통합
동일한 연결을 프로그래밍 방식으로 생성하고 관리합니다.
앱 연결
사전 구축된 Google, Slack, HubSpot, Salesforce 및 Cal.com 연결입니다.
MCP 서버 추가
전체 도구 서버를 에이전트에 노출합니다.
통합 API 레퍼런스
통합 리소스의 모든 필드입니다.