メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt

Use this file to discover all available pages before exploring further.

Discord Bot の Gateway 常時接続 を通じて CowAgent を接続します。ダイレクトメッセージ(DM)およびサーバーチャンネル(@メンションまたはボットへの返信で起動)に対応。Gateway は WebSocket の常時接続を使うため公開 IP やコールバック URL は不要で、すぐに利用できます。

1. 接続手順

ステップ 1: Discord アプリと Bot を作成

  1. Discord 開発者ポータル を開き、New Application をクリックして名前(例: CowAgent)を入力し作成します。
  2. 左メニューの Bot ページで Reset Token をクリックして Bot Token を生成し、コピーして安全に保管します(一度だけ表示されます)。
この Token は Bot のパスワードに相当します。漏洩しないようにしてください。万一漏洩した場合は Bot ページで再度 Reset Token をクリックして再生成できます。

ステップ 2: Message Content Intent を有効化

DM・チャンネルいずれもテキスト読み取りにこの権限が必要です。
  1. Bot ページの Privileged Gateway Intents を探します。
  2. Message Content Intent をオンにして保存します。
この権限を有効にしないと、受信メッセージの本文が空になり、ボットが応答しません。

ステップ 3: Bot をサーバーに招待

  1. 左メニューの OAuth2 → URL Generator を開きます。
  2. Scopesbot をチェックします。
  3. Bot Permissions で最低限以下をチェックします: Send MessagesRead Message HistoryAttach FilesView Channels
  4. 下部に生成された認証 URL をコピーしてブラウザで開き、対象のサーバーを選択して認証を完了します。
DM のみを利用する場合はこのステップを省略できますが、ボットとの DM チャンネルが必要です(ユーザーがボットに直接メッセージを送るなど)。

ステップ 4: CowAgent に接続

Web コンソール(既定 http://127.0.0.1:9899)を開き、チャネル メニュー → チャネルを追加Discord を選択し、Bot Token を貼り付けて接続をクリックします。
ログに以下のような出力が表示されれば接続成功です:
[Discord] Bot logged in as CowAgent#1234 (id=123456789)
[Discord] ✅ Discord bot ready, listening for messages

2. 機能

機能対応状況
ダイレクトメッセージ(DM)
サーバーチャンネル(@bot / ボットへの返信)
テキストメッセージ✅ 送受信
画像メッセージ✅ 送受信
ファイルメッセージ✅ 送受信(PDF / Word / Excel など)
Discord の 1 メッセージは最大 2000 文字です。長い返信は改行単位で自動的に複数メッセージに分割して送信されます。

3. 使い方

接続が完了したら:
  • ダイレクトメッセージ(DM): サーバーのメンバー一覧からボットを見つけ、アイコンをクリックして直接メッセージを送ります。
  • チャンネル: ボットを招待したチャンネルで、@your-bot こんにちは または ボットのメッセージへの返信 で起動します。
画像やファイルを送るときは、添付の入力欄に テキスト説明(説明・質問)を書いて一緒に送信できます。Bot は添付ファイルと説明を合わせて回答します。先に添付を送り、その後に質問を送る形でも、2 つのメッセージは自動でまとめて処理されます。