Web API
어떤 엔진에서든 캐릭터 호출
Neocortex Web API를 사용하면 어떤 엔진, 언어, 플랫폼에서든 일반 HTTP로 에디터에서 만든 캐릭터와 대화할 수 있습니다. Neocortex SDK가 하는 모든 일이 같은 엔드포인트를 거치므로, 자체 엔진이든 게임 서버든 백엔드 도구든 SDK 프로젝트와 똑같은 캐릭터를 사용합니다. 캐릭터 ID와 플레이어의 메시지를 보내면, 게임이 바로 활용할 수 있는 구조화된 데이터로 답변이 돌아옵니다.
Web API 기능
Web API는 SDK가 없는 엔진, 서버, 그리고 HTTPS 요청을 보낼 수 있는 모든 것을 위한 연결 통로입니다.
3가지 핵심 기능과 장점
하나의 기본 URL로 채팅, 그룹 채팅, 대화 기록, 텍스트 음성 변환, 스트리밍 음성, 음성 텍스트 변환을 모두 제공하며, 팀 단위로 발급되는 API 키로 인증합니다. 다른 장점은 다음과 같습니다.
답변은 긴 글 덩어리가 아닌 구조화된 데이터입니다. 각각 감정 태그가 붙은 한 줄에서 세 줄의 대사, 캐릭터가 고른 게임 내 행동과 각 행동이 겨냥하는 오브젝트의 ID, 그리고 이번 턴이 도달한 대화 흐름 체크포인트가 담겨 있습니다.
게임은 캐릭터가 무엇을 인식하고 있는지, 방금 무슨 일이 있었는지 알려 줄 수 있으며, 요청당 최대 40개의 엔티티와 20개의 이벤트를 보낼 수 있습니다. 세계 데이터는 언제나 데이터로만 취급되며, 지시로 해석되지 않습니다.
사용량 엔드포인트는 대시보드에서 설정한 한도 대비 플레이어별, 캐릭터별 사용량을 알려 주므로, 게임은 호출하기 전에 플레이어가 한도를 넘었는지 확인할 수 있습니다.
브라우저 게임에서는 Web SDK가 작은 서버 프록시를 추가해 API 키를 서버에 보관하므로, 브라우저에는 키가 노출되지 않습니다.