Web API
どのエンジンからでも呼び出せる
Neocortex Web API を使えば、どんなエンジン、言語、プラットフォームからでも、エディタでつくったキャラクターとシンプルな HTTP でやり取りできます。Neocortex の SDK が行うことはすべて同じエンドポイントを通るので、独自エンジンでも、ゲームサーバーでも、バックエンドのツールでも、SDK を使ったプロジェクトとまったく同じキャラクターを利用できます。キャラクター ID とプレイヤーのメッセージを送れば、ゲームでそのまま扱える構造化データで返答が返ってきます。
Web APIの機能
Web API は、SDK のないエンジンやサーバー、そのほか HTTPS リクエストを送れるあらゆるもののための手段です。
3 つの主な機能とメリット
ひとつのベース URL で、チャット、グループチャット、会話履歴、テキスト読み上げ、ストリーミング音声、音声認識をまとめて提供し、チーム単位の API キーで認証します。そのほかのメリットは次のとおりです。
返答はひと塊の文章ではなく、構造化データです。それぞれ感情タグの付いた 1 から 3 行のセリフ、キャラクターが選んだゲーム内アクションと各アクションの対象オブジェクトの ID、そしてそのターンで到達した会話フローのチェックポイントが含まれます。
ゲームからキャラクターに、何が見えているか、直前に何が起きたかを伝えられます。1 リクエストあたり最大 40 件のエンティティと 20 件のイベントを送れます。ワールドデータは常にデータとして扱われ、指示として解釈されることはありません。
使用量エンドポイントは、ダッシュボードで設定した上限に対するプレイヤー別・キャラクター別の使用量を返すので、ゲームは呼び出す前に、プレイヤーが上限を超えているかどうかを判断できます。
ブラウザゲーム向けには、Web SDK が小さなサーバープロキシを提供します。API キーはサーバー側に置かれ、ブラウザから見えることはありません。