본문으로 건너뛰기

API 커넥터

image-20241104-070152.png

예상 소요 시간: 7분

LaaS API 커넥터 기능을 활용하여 외부 API를 쉽게 연동하고, 서비스 기능을 확장하는 방법을 안내합니다. LaaS의 API 커넥터를 사용하면 다양한 외부 데이터를 활용하여 보다 강력한 AI 응답을 생성할 수 있습니다.

🔗 LaaS 무료 체험하기

개요​

API 커넥터는 LaaS 내에서 외부 API를 호출할 수 있도록 지원하는 기능입니다. 이를 통해 검색, 데이터 조회, 분석 API 등과 연동하여 AI의 응답을 강화할 수 있습니다.

주요 기능:

  • 외부 API 연동을 통한 데이터 활용

  • API 요청 및 응답 미리보기 기능 제공

  • HTTP 요청 파라미터 및 헤더 설정 가능

  • 특정 프리셋 내 API 호출을 자동화

주요 개념 및 필요성​

API 커넥터는 AI 모델이 단순한 언어 생성 역할을 넘어 실제 데이터에 기반한 응답을 제공할 수 있도록 돕습니다.

  • 실시간 데이터 활용: 최신 뉴스, 법률 정보, 환율 데이터 등 실시간 데이터를 포함한 응답 가능

  • 비즈니스 로직 확장: 사내 데이터베이스와 연동하여 맞춤형 AI 서비스 구축

  • 자동화된 워크플로우 지원: AI가 특정 조건에서 API를 호출하여 자동 응답

설정 방법​

1️⃣ API 커넥터 추가하기​

  1. 좌측 메뉴에서 API 커넥터 클릭

  2. 오른쪽 패널에서 API 커넥터 선택

    image-20250214-044603.png

  3. 기존 API 선택 또는 "+ API 커넥터 추가" 클릭

    image-20250214-044752.png

  4. API 정보를 입력

    • API 이름 설정

    • 요청 URL 입력 (예: https://api.example.com/data?query=${text})

      image-20250214-044837.png

2️⃣ 요청 파라미터 설정​

  • URL에 포함될 변수({text} 등)를 추가하여 동적인 API 호출 설정

  • 필수 파라미터(예: API 키) 입력

    image-20250214-044904.png

3️⃣ HTTP 헤더 설정​

  • API 호출 시 필요한 인증 헤더 입력 (예: Authorization: Bearer <token>)

    image-20250214-044931.png

4️⃣ 결과 미리보기​

  • API 실행 후 응답을 JSON 형식으로 미리 확인 가능

    image-20250214-044944.png

5️⃣ 저장 및 적용​

  • 입력한 설정을 저장 후 프리셋에서 활용 가능

    image-20250214-045220.png

사용 예제​

✅ 네이버 검색 API 연동하기​

  1. API 커넥터에서 "네이버 검색" API 추가

  2. URL 입력: https://openapi.naver.com/v1/search/${type}.json?query=${query}&display=10&sort=sim&start=1

  3. 요청 파라미터 설정

    • type: news (검색 타입)

    • query: ${text} (검색할 키워드)

  4. HTTP 헤더 추가

    • X-Naver-Client-Id: abc123

    • X-Naver-Client-Secret: xyz456

  5. 저장 후 프리셋에서 API 실행

  6. 결과 미리보기에서 JSON 응답 확인


문제 해결 (FAQ)​

🔹 Q. API 호출 시 인증 오류가 발생합니다.​

👉 API 제공자의 인증 방식(API Key, OAuth 등)을 확인하고, 올바른 인증 값을 HTTP 헤더에 추가했는지 검토하세요.

🔹 Q. API 응답이 예상과 다릅니다.​

👉 요청 파라미터 설정이 올바른지 확인하고, 응답 미리보기 기능을 활용하여 테스트 후 저장하세요.

🔹 Q. API를 여러 프리셋에서 사용하고 싶습니다.​

👉 현재 API 커넥터는 프로젝트 단위로 관리되므로, 다른 프리셋에서 동일한 API를 사용하려면 추가 등록이 필요합니다.

관련 문서 및 다음 단계​

🔗 LaaS 시작하기
🔗 LaaS API 가이드
🔗 LaaS 무료 체험하기

🚀 지금 API 커넥터를 활용하여 외부 데이터를 AI 모델과 연동해보세요!

image-20241104-070152.png