人狼知能コンテストでは、参加者が作成したエージェント（自動プレイヤー）を運営側が用意するゲームサーバにリモート接続することで、自動対戦を行います。ゲームサーバは下記の通り公開していますので、ご自分でゲームサーバを立ち上げてテストすることもできます。

エージェントの実装

エージェントの作成にあたっては、運営側が定義する仕様を満たした通信をするネットワーク接続の対戦エージェントを実装いただきます。人狼知能大会には別にプロトコル部門があり、基本的に仕様は同一ですがネットワーク対戦であること、プロトコル（人狼言語）ではなく自然言語（日本語または英語）を用いる点など（詳細は下記）が異なります。エージェント作成に当たってはライブラリ非互換性の問題を避けるため、プロトコル部門の提供するライブラリではなく下記の公開リポジトリのコードをベースに実装してください。

ゲームの実行

各エージェント（自動プレイヤー）は、運営の提供するゲームサーバに接続することでゲームの実行をすることができます。本戦においては運営が実行するゲームサーバに接続し、他のチームと対戦することで、予選においては参加者各自が参加トラックに応じて5体または9体のエージェントを運営が実行するゲームサーバに接続することで、自己対戦を行います。

サンプルエージェントとゲームサーバのソースコード

環境構築や実行方法についてはREADMEを参照してください。お問い合わせは、リポジトリのIssueによる報告もしくはメール、Slackに参加している場合はSlackでお願いいたします。

エージェントへの要求事項

エージェントを実装するにあたり必要な注意事項や要求事項に関しては下記ページをご確認ください。
大会レギュレーション

エージェント実装の詳細とゲームサーバについて

エージェントの実装にあたっては、下記ドキュメントをお読みの上、詳細必要であればソースコードを参照して下さい。

対戦のビューア

エージェント同士の対戦をブラウザ上で観戦できるプログラムです。エージェントの実装には必須ではありませんが、観戦用途やログビューアとして必要に応じてご活用いただけます。

aiwolf-nlp-viewer

投票結果の参照について

ゲームサーバの設定で vote_visibility: true が有効になっている場合、各エージェントは daily_initialize のタイミングで他のエージェントの投票結果（info.vote_list）および襲撃投票結果（info.attack_vote_list）を受け取ることができます。

サンプルエージェント（aiwolf-nlp-agent-llm）では、プロンプトテンプレート内の daily_initialize で以下のように参照しています。

{% if info.vote_list is not none -%}
投票結果: {{ info.vote_list }}
{%- endif %}
{% if info.attack_vote_list is not none -%}
襲撃投票結果: {{ info.attack_vote_list }}
{%- endif %}

各 Vote オブジェクトは day（日数）、agent（投票者）、target（投票先）のフィールドを持ちます。投票や襲撃の判断材料として活用してください。

いつでも発話トラックへの対応

いつでも発話トラックに対応したサーバプログラムは公開済みです。雛形エージェント・ビューアは4月中を目処に公開予定です。

ターンベースとの違い

従来方式ではサーバが各エージェントに順番に TALK リクエストを送信し応答を待機しますが、いつでも発話トラックではエージェントが能動的に発話を送信する方式に変わります。

  • TALK_PHASE_START 受信後、サーバの要求を待たず自発的に発話を送信する
  • 他エージェントの発話は TALK_BROADCAST でリアルタイム配信される（new_talk フィールドを参照）
  • TALK_PHASE_END 受信後は送信禁止（以降の送信は無視される）
  • 発話を終了する場合は Over を送信する（全員が送信すると早期終了）
  • WHISPER フェーズも同様に WHISPER_PHASE_START / WHISPER_BROADCAST / WHISPER_PHASE_END を使用

モードの判別方法

ゲーム開始時の Settings に talk.duration（ミリ秒単位の整数）が含まれる場合はいつでも発話トラック、含まれない場合はターンベース方式です。

パケット構造

TALK_BROADCAST には new_talk フィールドが追加されており、1件の新規発話が格納されています。

{
  "request": "TALK_BROADCAST",
  "info": { ... },
  "new_talk": { "idx": 0, "day": 1, "turn": 0, "agent": {...}, "text": "..." }
}