このガイドでは、AI ボット - エージェントをチャットやプライベートメッセージ（PM）の体験に統合する方法について説明します。
必要なユーザーレベル：管理者
エージェント向けチャットと PM の設定
チャットやトピックへの言及と統合するには、エージェントに
Userが作成され、Default Language Modelが選択されている必要があります。
-
Allow Personal Messagesを有効にすると、ユーザーがエージェントに PM を送信できるようになります。 -
Allow Topic Mentionsを有効にすると、許可されたグループのユーザーがトピック内でこのエージェントに言及できるようになります。 -
Allow Chat Direct Messagesを有効にすると、ユーザーエージェントがダイレクトメッセージ（DM）を受信できるようになります。 -
Allow Chat Channel Mentionsを有効にすると、許可されたグループのユーザーがチャットチャンネル内でこのエージェントに言及できるようになります。
チャットエージェントの設定のヒント
チャット用のエージェントを設定する際は、以下のヒントを参考にしてください。
-
Max Context Posts: チャットメッセージは短くなりがちです。言及に特化したエージェントの場合は、
Max Context Posts設定をより高い値に増やすことを検討してください。これにより、AI が以前のメッセージからより多くのコンテキストを維持できるようになります。 -
Default LLM と User: チャットおよびトピックへの言及を有効にするには、デフォルトの LLM（言語モデル）と User の両方を有効にする必要があります。これらの設定を適切に設定してください。
-
PM ベースの機能: PM ベースのエージェントで利用可能なすべての機能は、チャットエージェントでも利用可能です。ただし、PM で表示されるオプションの詳細なデバッグ情報は、チャットでは表示されません。
チャット相互作用の監査
チャット相互作用の監査は、他の方法に比べると少し複雑になる場合があります。ただし、ai_api_audit_logs にはすべてのチャット相互作用の完全なログが残ります。Discourse のデータエクスプローラーを使用して、これらのログをクエリできます。
チャットの動作
チャットエージェントと対話する際は、以下の動作に注意してください。
-
DM: DM 経由でボットに送信される新しいメッセージごとに、無条件に新しいスレッドが作成されます。
-
チャンネル: チャンネル内でボットに言及した場合、返信は現在のコンテキストに追加されます。既存のスレッド内で言及された場合は、そのスレッド内でボットが返信します。メインチャンネル内で言及された場合は、ボットが直接チャンネル内で返信します。
