ドキュメントを検索...

入力してドキュメントを検索

チャットガイド

トリガーとLua

すべてのメッセージの周囲で走る自動化。

トリガーはキャラクターに付くイベント駆動のスクリプトです。チャット開始時やメッセージの前後に発火し、履歴の読み取り、変数の設定、システムテキストの注入、送信の中止ができます。

スクリプト形式はRisuAIトリガースクリプトv2互換のインデント式コマンドなので、既存カードの自動化はそのままインポートして動きます。

低レベルアクセスを持つスクリプトは、チャットの外へ届くエフェクトを解放します:

runLLM checkSimilarity extractRegex runImgGen showAlert sendAIprompt triggerlua

LLM と画像のエフェクトは実際にモデルを呼び、トークンを消費します。サインインが必要で、あなたのアカウントを通じて実行されます。

トリガーのVMを超えるロジックには、キャラクターに Lua を持たせられます。ランタイムはおよそ50の関数を公開します:チャットへのアクセス、変数、アラート、LLM 呼び出しなど。RisuAI の Lua と互換です。

lua
onOutput = async(function(triggerId)
  local msg = getChat(triggerId, -1)
  if string.find(msg.data, "secret") then
    alertNormal(triggerId, "Secret mentioned!")
  end
end)
listenEdit("editoutput", function(triggerId, data)
  return data:gsub("%s+$", "")
end)

Lua のフックは処理の途中でテキストを書き換えます:組み立て前の入力、保存前の出力、送信前の生のリクエスト。

フックは同じ段階の正規表現スクリプトと順番に実行されます。パイプライン全体の結果はリクエストログで確認できます。

表示モードとリクエストモードのスクリプトは、限定されたコマンドのサンドボックスで実行されます。スクリプトがアカウント、キー、他の会話に触れることはできません。最悪でも自分のチャットを乱すだけです。