API 등록을 마쳤다면 다음은 Function 등록입니다. Function은 등록한 API에서 실제로 호출할 기능 하나하나를 정의하는 단위입니다. 하나의 API에 여러 개의 Function을 등록할 수 있습니다.
API 등록이 “어느 서비스와 연결할지”를 정하는 단계라면, Function 등록은 “그 서비스에서 무엇을 할지”를 정하는 단계입니다.
Function 등록하기
Functions 탭을 선택한 뒤 추가 버튼을 클릭합니다.

입력 항목
| 항목 | 내용 |
|---|---|
| 사용할 API | 앞 단계에서 등록한 API 중 선택 |
| Function Name | 영문·숫자·밑줄 조합으로 작성 (예: get_weather_info) |
| Description | AI가 이 기능을 언제, 어떻게 사용할지 판단하는 기준 |
| 메서드와 경로 | GET / POST 등을 선택하고 Base URL 뒤에 붙을 경로 입력 (예: /weather) |
| 파라미터 | 파라미터 추가 버튼으로 호출에 필요한 값 정의 |

Description 작성 요령
이 항목이 외부 API 연동에서 가장 중요합니다. Description은 AI가 이 Function을 호출할지 판단하는 근거가 되기 때문입니다. 잘 쓰면 AI가 알아서 적절한 순간에 기능을 사용하고, 부실하면 호출해야 할 때 호출하지 않거나 엉뚱한 값을 넣습니다.
다음 세 가지를 예시와 함께 적어 주세요.
- 어떤 상황에서 호출하는지
- 값이 없을 때 어떻게 할지
- 입력값을 어떤 형식으로 변환할지
작성 예시
지역별 날씨를 조회한다. 도시 이름이 없으면 사용자에게 먼저 물어본다. 자연어 지역명을 도시 영문명으로 변환해q파라미터로 설정한다. 예: ‘경기도 광주’ → ‘Gwangju-si,KR’
예시에서 눈여겨볼 점은 변환 규칙까지 구체적으로 적었다는 것입니다. 고객은 “광주 날씨 어때요”라고 묻지 “Gwangju-si,KR”이라고 입력하지 않습니다. 사람이 쓰는 말과 API가 요구하는 형식 사이의 간극을 Description이 메워줍니다.
사내 시스템을 연동한다면 이런 식으로 쓰시면 됩니다. “상품 재고를 조회한다. 고객이 상품명으로 물어보면 상품 코드로 변환해 조회한다. 상품을 특정할 수 없으면 어떤 상품인지 먼저 확인한다.”
파라미터 설정
파라미터 추가 버튼을 눌러 API 호출에 필요한 값을 하나씩 정의합니다.
입력 항목
- 이름 — API 문서에 정의된 파라미터명 그대로 입력
- 타입 — 문자열(string), 숫자(number) 등 선택
- 필수 항목 — 호출에 반드시 필요한 값이면 체크
- 설명 — AI가 값을 채울 때 참고할 내용
- 기본값 — 항상 같은 값이거나 입력이 없을 때 사용할 값
이름은 반드시 API 문서에 나온 그대로 써야 합니다. 대소문자 하나만 달라도 호출이 실패합니다.
날씨 API 예시
다음은 날씨 API에 필요한 세 가지 파라미터를 등록한 예시입니다. 성격이 각각 다르니 비교해서 보시면 이해가 빠릅니다.



세 파라미터를 정리하면 이렇습니다.
| 파라미터 | 성격 | 설정 방법 |
|---|---|---|
q (도시 이름) |
고객마다 다른 값 | 필수 항목 체크, 기본값 없음 |
units (단위) |
항상 같은 값 | 기본값에 metric 입력 |
appid (인증 키) |
항상 같은 값 | 기본값에 발급받은 키 입력 |
파라미터 설정 팁
API Key처럼 항상 같은 값은 기본값에 미리 입력해 두면 고객이 입력하지 않아도 자동으로 적용됩니다. 고객이 반드시 알려 주어야 하는 값에만 필수 항목을 체크하세요. 필수 값이 비어 있으면 AI가 고객에게 먼저 되물어봅니다.
필수 항목을 남발하지 않는 것이 요령입니다. 기본값으로 처리할 수 있는 값까지 필수로 지정하면, AI가 고객에게 불필요한 질문을 던지게 됩니다.
다음 단계
외부 API 연동 (3) — 테스트와 실제 적용에서 등록한 Function이 제대로 동작하는지 확인하고 상담에 적용합니다.

