API 요청 컴포넌트는 AI 워크플로우 내에서 HTTP 요청을 쉽게 처리할 수 있도록 설계된 다목적 도구입니다. 이 컴포넌트를 통해 워크플로우는 하나 이상의 URL로 요청을 보내고 응답을 처리하여 외부 API나 웹 서비스와 상호작용할 수 있습니다. 이 기능은 데이터 조회, 외부 서비스 연동, 맞춤형 엔드포인트 호출 등 자동화 또는 지능형 프로세스의 필수 요소입니다.
컴포넌트의 역할
이 컴포넌트는 지정한 URL로 HTTP 요청(GET, POST, PATCH, PUT)을 구성하여 전송할 수 있습니다. 헤더, 쿼리 파라미터, 요청 본문 등을 추가해 요청을 맞춤 설정할 수 있으며, 폼 데이터 처리와 요청 타임아웃 설정도 지원하여 다양한 API 연동에 적합합니다.
입력값
API 요청 컴포넌트는 다음과 같은 입력값을 지원합니다:
| 필드 | 설명 | 타입 | 기본값/옵션 |
|---|---|---|---|
| URL | 대상 URL을 하나 이상 입력하세요. 쉼표로 구분합니다. | 문자열 | |
| Method | 요청에 사용할 HTTP 메서드입니다. | 드롭다운 | GET, POST, PATCH, PUT |
| Headers | 요청에 포함할 사용자 지정 헤더(딕셔너리 형태). | 딕셔너리/데이터 | |
| Body | POST, PATCH, PUT 요청의 데이터 페이로드(딕셔너리 형태). | 딕셔너리/데이터 | |
| Query Parameters | URL 쿼리 파라미터로 추가할 키-값 쌍. | 딕셔너리/데이터 | |
| Use Form Data | 데이터를 application/x-www-form-urlencoded로 전송할지 여부. | 불리언 | false |
| Timeout | 요청이 타임아웃되기 전까지의 시간(초 단위). | 정수 | 5 |
| Cache TTL | API 응답을 캐시할 시간. ‘캐시 없음’으로 설정 시 비활성화. | 드롭다운 | 캐시 없음, 5분, … 등 |
| Verbose | 활성화 시 디버깅을 위한 상세 출력 표시. | 불리언 | false |
| Tool Name | 이 API 요청 도구의 이름(에이전트에서 사용). | 문자열 | |
| Tool Description | 에이전트가 도구 사용법을 이해할 수 있도록 하는 설명. | 문자열(여러 줄) |
출력값
이 컴포넌트는 두 가지 주요 출력을 제공합니다:
| 출력 이름 | 타입 | 설명 |
|---|---|---|
| Data | 데이터 | API 요청의 응답 데이터. |
| Tool | 도구 | 에이전트 기반 워크플로우에서 “도구"로 사용 가능. |
이 컴포넌트를 사용하는 이유
- 통합: AI 워크플로우를 외부 API나 웹 서비스와 연결하여 신규 데이터나 동작을 손쉽게 추가할 수 있습니다.
- 유연성: 다양한 HTTP 메서드, 커스텀 헤더, 본문, 쿼리 파라미터 지원으로 간단한 호출부터 복잡한 API 연동까지 모두 대응합니다.
- 캐싱: 응답을 캐싱하여 성능을 높이고 중복 API 호출을 줄일 수 있습니다.
- 폼 데이터 지원: 폼 인코딩 데이터가 필요한 엔드포인트에 쉽게 제출할 수 있습니다.
- 에이전트 친화적: 도구 이름과 설명을 정의해 에이전트 기반 AI 워크플로우에서 도구로 활용할 수 있습니다.
활용 예시
- 공개 API에서 실시간 데이터(예: 날씨, 뉴스, 금융정보) 수집
- 외부 서비스(예: CRM, 티켓 시스템)로 정보 제출
- 데이터 처리 또는 워크플로우 자동화를 위한 맞춤형 백엔드 엔드포인트와 통합
- LLM 에이전트가 추론 또는 작업 수행 과정에서 외부 API 호출
요약
API 요청 컴포넌트는 웹 서비스나 외부 데이터 소스와 상호작용해야 하는 모든 AI 프로세스의 필수 구성 요소입니다. 다양한 HTTP 요청 시나리오를 처리할 수 있는 폭넓은 설정 옵션을 제공하며, 출력값은 직접 활용하거나 에이전트 기반 AI 워크플로우에서 도구로 사용할 수 있습니다.
