> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 연결

> 모든 HTTP API를 에이전트가 대화 중간에 호출할 수 있는 함수로 전환합니다. cURL 명령어를 붙여넣으면 마법사가 나머지를 처리합니다.

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

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

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

<Steps>
  <Step title="새 API 연결을 클릭합니다">
    대화 상자가 마법사에서 열립니다. 상자에 샘플 **cURL 명령어**,
    **OpenAPI/Swagger 사양**, **Postman 내보내기**, **TypeScript
    인터페이스** 또는 **Zod 스키마**를 붙여넣습니다.
  </Step>

  <Step title="분석을 클릭합니다">
    ThunderPhone이 붙여넣은 내용에서 URL, 메서드, 헤더, 그리고 발견한
    쿼리 매개변수와 요청 본문을 기반으로 한 매개변수 스키마를 포함한 전체 연결을 추론합니다.
    인증 헤더를 포함하여 붙여넣은 헤더는 엔드포인트 구성으로 가져옵니다.
  </Step>

  <Step title="강조 표시된 필드를 확인합니다">
    추론된 구성은 검토할 수 있도록 추정된 필드가 강조 표시된 상태로 열립니다.
    에이전트가 함수를 언제 어떻게 호출해야 하는지 이해할 수 있도록 이름, 설명, 매개변수 유형을 조정합니다.
    모델은 설명을 읽습니다.
  </Step>

  <Step title="검증 및 저장">
    저장하면 먼저 엔드포인트에 대해 실제 테스트 요청을 실행합니다. 요청이 실패하면 연결은 저장되지 않습니다.
    URL, 인증 헤더 또는 본문을 수정한 후 다시 시도합니다. 성공하면 연결이 **검증됨** 배지와 함께 저장됩니다.
  </Step>
</Steps>

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

## 수동 설정

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

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

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

<Tip>
  매개변수에 일반적인 언어로 된 설명을 제공합니다("고객 이메일 주소,
  예: [jane@example.com](mailto:jane@example.com)"). 에이전트는 통화 중 실시간으로 이러한 설명을 바탕으로 인수를 선택합니다.
</Tip>

## 연결 관리

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

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

## 에이전트에 연결하기

빌더의 API 연결 섹션에서 에이전트에 연결을 추가합니다
([에이전트 구축](/ko/guides/build-an-agent)). 목록에는 각 연결을 사용하는 에이전트가 표시되므로 변경 사항이 무엇에 영향을 주는지 한눈에 확인할 수 있습니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="API를 통한 도구 통합" icon="code" href="/ko/guides/build-tool-integration">
    동일한 연결을 프로그래밍 방식으로 생성하고 관리합니다.
  </Card>

  <Card title="앱 연결" icon="cable" href="/ko/guides/connect-apps">
    사전 구축된 Google, Slack, HubSpot, Salesforce 및 Cal.com 연결입니다.
  </Card>

  <Card title="MCP 서버 추가" icon="server" href="/ko/guides/mcp-servers">
    전체 도구 서버를 에이전트에 노출합니다.
  </Card>

  <Card title="통합 API 레퍼런스" icon="book" href="/api-reference/integrations">
    통합 리소스의 모든 필드입니다.
  </Card>
</CardGroup>