챗봇을 API로 연결하기
게시한 챗봇을 타임리AI 밖(학과·부서 홈페이지, 학습관리시스템, 사내 업무 시스템 등)에서 불러 쓸 수 있어요. 연결 주소는 OpenAI 호환 주소라서, OpenAI SDK를 쓰는 개발자라면 주소와 키만 바꾸면 돼요. 이 챗봇의 지시문·모델·지식 문서·도구가 그대로 적용돼요.
어디서
섹션 제목: “어디서”| 위치 | 버튼 |
|---|---|
| 챗봇 편집 화면 오른쪽 위 | 「API로 호출」 (넓은 화면에서만 보여요) |
| 챗봇 대화 화면 오른쪽 위 ⋯ | 「API로 연결」 |
| 「내 챗봇」 카드 ⋯ | 「API로 연결」 (게시 뒤에만) |
어떻게
섹션 제목: “어떻게”- 챗봇을 먼저 게시해요. 게시 전이면 창에 “연결 주소와 예시 코드는 게시한 뒤에 열려요.” 와 「게시하기」(승인이 필요한 스페이스는 「게시 요청하기」)만 보여요 → 챗봇 게시하기
- 「API로 연결」(편집 화면은 「API로 호출」)을 눌러 API로 연결 창을 열어요.
- 연결 주소(OpenAI 호환 주소, baseURL) 옆 「복사」 를 눌러요 — “연결 주소를 복사했어요”.
- 연동 키를 골라요.
- 키가 없으면 “아직 연동 키가 없어요” 아래 「연동 키 만들기」 를 눌러요. 만든 키는 그 자리에서 한 번만 원문이 보여요 — 꼭 따로 보관하세요.
- 이미 있으면 드롭다운에서 고르거나 「새 키 만들기」. 키 목록 관리는 「연동 키 관리」 ↗(내 계정 설정 › 보안 › 연동 키 관리)에서 해요.
- 예시 탭에서 Python / curl / JavaScript 중 하나를 골라 「복사」 해요(“예시 코드를 복사했어요”). 고른 키와 첫 추천 질문이 예시에 채워져 있어요.
- 개발 담당자에게 연결 주소·키·예시 코드를 전달해요.
창에서 보이는 것
섹션 제목: “창에서 보이는 것”| 항목 | 설명 |
|---|---|
| 연결 주소 | 이 챗봇 전용 OpenAI 호환 주소예요. 요청의 model 값은 아무거나 넣어도 되고(예시는 chatbot), 이 챗봇 설정이 쓰여요 |
| 연동 키 | 「내 연동 키로 호출하고, 크레딧도 이 키 주인에게 ‘API 채팅’으로 차감돼요.」 |
| 예시 | Python · curl · JavaScript 예시 코드 |
| 이 챗봇 설정이 그대로 적용돼요 | 지시문 · 모델 · (추론 강도) — 요청에 보낸 model, system 메시지는 쓰지 않아요 / 지식 문서 N개 — 답변에 출처가 함께 와요 / 도구 / 개인정보 차단 · 금칙어 정책 — 스페이스 보안 정책이 API에도 똑같이 적용돼요 |
| 이번 달 API 답변 N회 | 이번 달 외부에서 부른 답변 수. 「통계에서 자세히 보기 ›」 로 챗봇 통계에 가요 |
주의·팁
섹션 제목: “주의·팁”Q. 자주 묻는 질문
섹션 제목: “Q. 자주 묻는 질문”Q. 「API로 연결」 메뉴가 안 보여요. 스페이스에 연동 키 기능이 열려 있지 않거나, 내가 그 챗봇의 소유자·공동 편집자가 아니에요. 카드 ⋯ 메뉴에서는 게시 뒤에만 보여요.
Q. 요청에 다른 모델을 적었는데 챗봇 모델로 답해요.
정상이에요. API로 부르면 챗봇에 저장된 지시문과 모델이 쓰이고, 요청의 model·system 메시지는 무시돼요. 모델을 바꾸려면 챗봇 설정에서 바꿔 주세요.
Q. 챗봇 내용을 고치면 API에도 바로 반영되나요? 네. API는 저장된 챗봇 설정을 그대로 불러요.