Wiring Lab
Wiring Lab 에서 페르소나와 엔진을 연결합니다. 이 연결을 링크: 라고 부릅니다. 페르소나 하나와 엔진 하나를 정확히 짝지어, 엔진이 그 페르소나의 목소리로 돌아가게 합니다. 링크마다 고유한 api_slug가 붙습니다. 이 배선을 가리키는 고유 식별자라서, 플랫폼은 어떤 요청이 어느 페르소나·엔진 조합에 속하는지 항상 알 수 있습니다.
링크를 만들려면:
- Wiring Lab 을 열고 가동할 페르소나를 고르세요.
- 엔진을 끌어다 라이브러리에서 캔버스로 놓아 그 페르소나에 붙입니다.
- 저장 ( 배선 적용 버튼)을 눌러 링크를 확정하세요. 적용하기 전까지는 배선이 저장되지 않습니다.
한 계정에서 페르소나·엔진 링크를 여러 개 만들 수 있습니다. 각각이 독립된 연결이며 고유한 api_slug를 가집니다.
API 키
API 키 는 외부 봇이나 연동이 FluidTalk에 인증하는 수단입니다. 만드는 방법은 두 가지입니다:
- 생성: 아직 어떤 페르소나나 엔진에도 묶이지 않은, 계정 전체용 기본 키를 발급합니다.
- 발급(연결 포함): 한 번에 특정 페르소나와 엔진에 한정된 키를 발급합니다. 이쪽이 권장 경로입니다. 이미 한정된 키는 바로 실제 트래픽을 처리할 수 있으니까요.
키 관리는 Wiring Lab에서 합니다:
- 키 연결·한정: 이미 있는 계정 전체용 키를 페르소나와 엔진에 묶습니다(원하면 이름도 바꿀 수 있습니다). 한 번도 한정되지 않은 키는 실제 호출을 처리할 수 없습니다.
- 목록: 계정의 모든 키를 봅니다.
- 폐기: 키를 지워 더 이상 쓸 수 없게 합니다.
참고하세요
API 키의 비밀값은 만들어지는 그 순간 딱 한 번만 보입니다. 그때 복사해서 안전한 곳에 보관하세요. 잃어버리면 다시 볼 수 없습니다. 그 키를 폐기하고 새로 만드시면 됩니다.
참고하세요
실제 트래픽을 처리하려면 키가 먼저 페르소나에 한정 (그리고 엔진에 한정)되어 있어야 합니다. 한정되지 않은 계정 전체용 키는 실제 호출에서 거부됩니다. 한정된 키를 발급하거나 기존 키를 먼저 연결하세요.
가동 전 체크리스트
이 네 가지가 모두 참이면 실제로 가동 중입니다:
- 페르소나 준비 완료: 정체성과 사진이 설정돼 있음.
- 엔진 연결됨: 그 페르소나에 엔진을 배선하고 Wiring Lab에서 적용함.
- 한정된 API 키: 바로 그 페르소나와 엔진에 발급(또는 연결)돼 있음.
- 봇을 핸드셰이크로 향하게 하기: 연동 쪽에서 들어온 메시지마다 실서비스 핸드셰이크 엔드포인트로 보내면서, 키를 다음 헤더에 담습니다: X-API-Key . FluidTalk가 다음 메시지와 취할 동작을 돌려줍니다.
정확한 엔드포인트, 요청 필드, 응답은 개발자 API 레퍼런스를 보세요.
팁
써 보려고 굳이 실제로 가동할 필요는 없습니다. 먼저 내장 시뮬레이터 에서 대화를 통째로 돌려 보세요(같은 엔진, 키도 실제 트래픽도 없이). 원하는 대로 움직이면 그때 배선하면 됩니다.
참고하세요
실제 대화를 서비스하려면 활성 유료 플랜이 필요합니다. 무료이거나 만료된 계정은 핸드셰이크 단계에서 거절되므로, 플랜이 끝나는 순간 봇도 서비스를 멈춥니다. 참고: 결제와 플랜.
관련 가이드
- 엔진 빌더: 배선하기 전에 대화를 설계하세요.
- 시뮬레이터에서 테스트: 키 없이 엔진을 처음부터 끝까지 돌려 보세요.
- 개발자 API 레퍼런스: 정확한 핸드셰이크 호출과 헤더.
- 결제와 플랜: 유료 플랜이 실서비스에 열어 주는 것들.