API

API 노드

외부 API를 호출하여 데이터를 조회하거나 외부 시스템과 연동하는 작업을 수행하는 노드입니다. API 요청 및 응답 처리 기능을 포함합니다.

Body

API 요청 시 서버로 전달할 추가 데이터를 JSON 형식으로 입력합니다.

주로 POST, PUT 요청에서 사용하며, GET 요청은 일반적으로 Body를 포함하지 않습니다.

💡 예시 코드

“이름, 이메일, 나이” 데이터를 전송하는 기본적인 Body 예시입니다. API에 따라 필요한 필드명과 데이터 구조는 달라질 수 있습니다.

{
  "name": "Hello World",
  "email": "HW@example.com",
  "age": 30
}

Header

요청에 포함할 HTTP 헤더를 정의합니다.

서버에 인증 정보를 전달하거나, 요청 본문이 어떤 형식인지 알릴 때 사용됩니다.

💡 예시 코드

{
  "Content-Type": "application/json",
  "Accept": "application/json",
  "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

Authorization

API 접근을 위한 인증 방식을 설정합니다.

Basic, Bearer 인증 방식을 지원합니다.

항목	필수 조건	선택 또는 불필요 조건	주요 사용 목적
Body	`POST`, `PUT` 요청 시 서버로 데이터를 전송해야 할 때	`GET`, `DELETE` 등 단순 조회 요청 시	요청 시 서버로 전달할 추가 데이터 입력
Header	서버가 요청 또는 응답의 데이터 형식을 명시적으로 요구할 때 또는 인증 정보를 헤더로 전달해야 할 때	인증이 필요 없는 공개 API이거나, 인증이 쿼리 파라미터로 처리될 때	요청/응답의 데이터 형식 지정 및 인증 정보 전달
Authorization	API가 사용자 인증을 요구할 때 (Bearer 토큰, Basic 인증, API Key 헤더 전달 등)	인증이 필요 없는 공개형 API 또는 인증이 URL 파라미터로 처리될 때	API 접근 권한 확인 및 사용자 인증

타임아웃

API 호출 시 응답 대기 최대 시간을 설정합니다.

활용 예시: SerpApi Google Flights 연동

전제: departure_id, arrival_id, outbound_date, return_date 변수가 변수 선언에서 미리 생성되어 있고, 멀티턴에서 변수 할당 노드로 각각 값이 설정된 상태

예시 시나리오

항공편을 조회해주는 에이전트를 설계하는 경우, API 노드는 외부 항공권 검색 서비스를 연결해 실제 데이터를 불러오는 역할을 합니다.

“11월 10일 인천에서 도쿄 가는 비행기 찾아주세요. 11월 19일에 복귀할 것 같습니다.”와 같이 입력하면, 대화 중 LLM 노드가 이 문장에서 출발지(인천), 도착지(도쿄), 출발일(11월 10일), 귀국일(11월 19일)의 정보를 인식하고, 변수 선언 및 변수 할당 노드를 통해 각각의 변수에 값을 저장합니다.

이렇게 저장된 변수값을 활용해 API 노드는 외부 항공권 조회 API에 실제 항공권 검색 요청을 전송합니다. 응답으로 전달된 항공편 목록이나 가격, 일정 등의 데이터는 후속 노드(LLM, RAG 노드)에서 활용할 수 있습니다.

1) 사전 확인 — 외부 API 문서에서 필수/선택 파라미터 및 제약 조건 검토

HTTP 메서드: GET

URL: https://serpapi.com/search?engine=google_flights

항목	설명
필수 파라미터 (`required`)	`engine`, `api_key`
선택 파라미터 (`optional`)	`departure_id`, `arrival_id`

2) 쿼리 파라미터 매핑

SerpApi 파라미터	설명	노드에서 바인딩할 변수
`engine`	사용 엔진 지정	`google_flights`(고정 값)
`departure_id`	출발 공항/지역 식별자	`{{custom_variables.departure_id.value}}`
`arrival_id`	도착 공항/지역 식별자	`{{custom_variables.arrival_id.value}}`
`outbound_date`	출국 날짜(YYYY-MM-DD)	`{{custom_variables.outbound_date.value}}`
`return_date`	귀국 날짜(YYYY-MM-DD, 선택)	`{{custom_variables.return_date.value}}`
`api_key`	SerpApi API Key	-

3) API 노드 입력 방법

API

메서드: GET

URL: https://serpapi.com/search.json

Body

GET 호출이므로 비워둡니다

Header

별도 헤더 불필요(SerpApi는 API 키를 쿼리 파라미터로 전달합니다)

Authorization

별도 설정 없음(인증은 api_key 쿼리 파라미터로 처리)

타임아웃

서비스 정책에 맞게 설정(예: 5000ms)

API 노드#

Body#

💡 예시 코드#

Header#

💡 예시 코드#

Authorization#

타임아웃#

활용 예시: SerpApi Google Flights 연동#

예시 시나리오#

1) 사전 확인 — 외부 API 문서에서 필수/선택 파라미터 및 제약 조건 검토#

2) 쿼리 파라미터 매핑#

3) API 노드 입력 방법#

API 노드

Body

💡 예시 코드

Header

💡 예시 코드

Authorization

타임아웃

활용 예시: SerpApi Google Flights 연동

예시 시나리오

1) 사전 확인 — 외부 API 문서에서 필수/선택 파라미터 및 제약 조건 검토

2) 쿼리 파라미터 매핑

3) API 노드 입력 방법