본문으로 건너뛰기

Function Calling 사용가이드

image-20241104-070152.png

예상 소요 시간: 7분

LaaS에서 Function Calling을 활용하여 외부 API와 연동된 함수를 호출하는 방법을 배워보세요. 이 가이드를 따라 함수 등록, 파라미터 설정, 자동 호출 방식 등을 익힐 수 있습니다.

🔗 LaaS 무료 체험하기

1. Function Calling 개요​

Function Calling은 LLM이 특정 입력을 감지하면 자동으로 외부 API를 호출하여 데이터를 조회하거나 기능을 실행하도록 설정하는 기능입니다.

✅ 활용 사례​

  • 날씨 조회: "서울의 날씨는?" → getWeather() 함수 실행

  • 환율 변환: "1달러는 몇 원이야?" → get_exchange_rate() 호출

  • 예약 가능 여부 조회: "내일 2시에 회의실 예약 가능해?" → checkAvailability()

📌 Function Calling을 사용하면 챗봇이 단순 응답 생성이 아닌, 실시간으로 외부 데이터를 활용하는 기능을 수행할 수 있습니다.

2. Function Calling 설정 방법​

🔹 2.1 함수 추가하기​

  1. LaaS 에디터에서 "함수 호출" 섹션을 찾습니다.

  2. "추가 +" 버튼을 클릭하여 새로운 함수를 등록합니다.

    image-20250214-083150.png

🔹 2.2 함수 등록​

  1. 함수 이름을 입력 (영문, 숫자, _ 만 사용 가능)

  2. 설명: 해당 함수가 수행하는 기능을 입력

  3. 파라미터 추가:

    • 이름: API 요청에 포함할 변수명

    • 설명: 해당 변수의 역할을 명확히 설명

    • 데이터 타입: String 또는 Number 중 선택

    • 필수 여부 설정

      image-20250214-083228.png

🔹 2.3 파라미터 추가​

추가적인 데이터 입력이 필요하면 "파라미터 추가" 버튼을 눌러 설정하세요.
예를 들어, 환율 변환 함수의 경우:

  • amount: 변환할 금액 (Number)

  • fromCurrency: 변환할 통화 코드 (String)

  • toCurrency: 변환할 대상 통화 코드 (String)

    image-20250214-083246.png

3. Function Calling 실행 및 테스트​

🔹 3.1 실행 흐름​

  1. 사용자가 요청을 입력

    "원 달러 환율 얼마야?"

  2. LLM이 해당 입력이 함수 호출이 필요하다고 판단

  3. 자동으로 get_exchange_rate() 함수를 호출

  4. API 응답값을 받아 사용자에게 전달

    image-20250214-083304.png

🔹 3.2 자동 호출 모드 설정​

Function Calling은 자동(auto) 모드로 실행됩니다.

  1. "auto" 옵션 선택 → AI가 필요 시 자동으로 함수 호출

  2. 특정 함수만 실행하려면 해당 함수를 선택

    image-20250214-083321.png

🔹 3.3 테스트 결과 확인​

  • Function Calling을 설정한 후 테스트 입력을 해보면, LLM이 적절한 파라미터와 함께 API 호출을 생성합니다.

    image-20250214-083341.png

4. Function Calling 활용 예제​

활용 사례

예제 입력

호출 함수

반환 데이터

날씨 조회

서울 날씨 알려줘

getWeather()

{ "temperature": "10°C", "condition": "맑음" }

환율 변환

1달러는 몇 원?

get_exchange_rate()

{ "exchangeRate": 1300 }

일정 예약

내일 2시 예약 가능?

checkAvailability()

{ "available": true }

5. 자주 발생하는 문제 해결 (FAQ)​

Q: Function Calling이 자동 실행되지 않습니다.​

🔹 해결 방법

  • 함수 설명이 모호하면 AI가 호출하지 않을 수 있음 → 설명을 명확히 입력

  • 파라미터 필수 여부 설정이 적절한지 확인

Q: API 응답이 이상하게 출력됩니다.​

🔹 해결 방법

  • JSON 응답이 필요한 데이터만 포함되도록 설정

  • JSON 스키마에서 additionalProperties: false 적용

Q: API 커넥터와 Function Calling을 함께 사용할 수 있나요?​

🔹 불가능합니다.
API 커넥터와 Function Calling은 동시에 활성화할 수 없습니다.
둘 중 하나만 선택해서 사용하세요.

Function Calling을 활용하면 LaaS에서 AI가 외부 데이터를 실시간으로 활용하여 보다 정확하고 동적인 응답을 제공할 수 있습니다.
적절한 함수 등록 및 설정을 통해 LLM이 API 데이터를 효과적으로 활용하도록 최적화하세요.

🔗 LaaS 무료 체험하기

image-20241104-070152.png