agentic-mentions

agentic-mentions

クイックスタート · API とコマンド · パッケージ

agentic-mentions は、受信したコメントを扱う開発者向けの、オープンソースのメンション振り分けツールキットです。 レコードの重複を排除し、テキストルールを適用して感情、意図、緊急度、推奨ルートを判定します。 Node.js ライブラリ、CLI、Model Context Protocol（MCP）サーバーから、このワークフローを利用できます。

インストール

npm install agentic-mentions

Node.js 18 以降が必要です。TypeScript 宣言と 2 つのランタイム依存関係が含まれています。

最初のメンションを振り分ける

ローカルでの振り分けに、認証情報や環境変数は必要ありません。

npx agentic-mentions mentions triage --text 'Could I get pricing?'

JSON の結果には、intent: "lead"、urgency: "medium"、suggestedRoute: "reply" が含まれます。 共有キューでは、同じプロセス内にストアを保持します。

import { createMentionStore, ingestMentions, queueMentions } from 'agentic-mentions';
const store = createMentionStore();
ingestMentions([{ text: 'Urgent outage problem', source: 'fixture' }], store);
console.log(queueMentions(store)[0].triage);

結果の緊急度は critical で、エスカレーションが提案されます。どちらの例も返信を送信しません。

仕組み

Supplied JSON / webhook payload / fixtures
                    |
              fingerprint deduplication
                    |
              in-memory mention store
                    |
              keyword-based triage
                    |
              urgency queue -> caller reviews -> mark handled

開発の背景

メンションのワークフローには、テキストラベルに加えてレコードの重複排除と処理状態が必要です。 Natural と Sentiment はテキスト分析の基本機能を提供します。このパッケージは固定ルールをローカルキューおよびエージェントツールと組み合わせます。

比較

Natural のソース と Sentiment のソース を基に、2026-10-14 に確認しました。 これらはローカルでのテキスト分析の代替手段であり、マネージドのソーシャルリスニングサービスではありません。

範囲	agentic-mentions	Natural	Sentiment
主な用途	メンションの重複排除と振り分け	自然言語処理の基本機能	単語リストによる感情スコアリング
デプロイ先	お使いの Node.js プロセス	お使いの Node.js プロセス	お使いの Node.js プロセス
設定	メンションレコードとストア	JavaScript API	JavaScript API と単語ラベル

対応範囲

入力またはアダプター	状況	動作
JSON ファイル	✓	CLI の取り込みは配列または {items: [...]} を受け付けます
汎用 Webhook	✓	SDK はペイロードを解析するか、指定された URL から JSON を取得します
フィクスチャのメンション	✓	SDK は指定されたレコードを読み込みます
ローカルルーター	✓	SDK は外部への送信なしで受領記録を生成します
HTTP ルーター	✓	SDK は指定されたエンドポイントに {text} を POST します
ソーシャルネットワーク API	—	ブランド固有のコネクターはありません

ソースの一覧には、メンション用アダプターが 2 つ、ルーティング用アダプターが 2 つ含まれています。ローカルテストではこれらの経路を検証しますが、外部サービスの認証情報は確認しません。 汎用 Webhook アダプターはパーサー兼フェッチクライアントであり、HTTP リスナーサーバーではありません。

一般的なユースケース

1. サポート担当の開発者は Node.js を使って、提供された苦情レコードを緊急度順に優先付けします。
2. コミュニティチームは JSON エクスポートと CLI を使って、振り分けラベルを事前確認します。
3. エージェント開発者は MCP クライアントを使ってレコードを取り込み、セッションキューを確認します。
4. バックエンド開発者は Node.js と汎用 JSON エンドポイントを使って、Webhook レコードを正規化します。

機能

• 重複排除： フィンガープリントは、同じストア内でアカウント、投稿者、正規化されたテキストを使って生成されます。
• 振り分け： ルールによって、感情、5 種類の意図、4 段階の緊急度、3 種類の推奨ルートが割り当てられます。
• キュー： 未処理のレコードは、緊急度、次に作成タイムスタンプの順で並べ替えられます。
• 処理状態： SDK はレコードを処理済みにします。CLI と MCP では、最初にプレビューを確認できます。
• テキストユーティリティ： SDK のエクスポートには、統計、ロギング、ディスパッチガード、ルーティングの受領記録が含まれます。

ランタイムのインターフェース

Node.js SDK は、メンションのワークフローとコアユーティリティをエクスポートします。パッケージには TypeScript の型定義が含まれています。

CLI コマンドは mentions ingest --file PATH、mentions queue、mentions triage --text TEXT、mentions handle --id ID です。 costs、mcp、--help / -h、--version / -V にも対応しています。 4 つのメンションコマンドでは、mentions プレフィックスを省略できます。状態を変更するには、処理時に --live が必要です。

npx agentic-mentions mcp
# Equivalent dedicated executable:
npx agentic-mentions-mcp

stdio サーバーは、ingest_mentions、triage_mention、mention_queue、mark_mention_handled の 4 つのツールのみを公開します。 処理はデフォルトでプレビューされます。処理済みにするには、live: true を設定してください。注入された承認コールバックによって、操作を拒否できます。 デフォルトのコールバックは承認します。対話型の承認プロンプトではありません。

ビルド済みの Worker エントリには、GET /health と、JSON の text 文字列を受け取る POST /summarize があります。 テキスト統計を提供しますが、メンションの取り込みは行いません。ご自身でデプロイしてください。マネージドサービスでも、パッケージルートからのエクスポートでもありません。

配信と動作の制限

ストアとコストレポートはメモリ上に保持されます。CLI を起動するたびに状態は初期化され、取り込みコマンドの内容が後続のキューに永続化されることはありません。 ルールでは固定の英語キーワードを使用します。文脈、皮肉、あらゆる言語を理解するものではありません。 このパッケージは返信、無視、エスカレーションを提案します。返信の送信や、ソーシャルネットワーク上のメンションの自動収集は行いません。 HTTP ルーターのデフォルトタイムアウトは 10 秒で、再試行や認証の設定はありません。 ディスパッチコストでは文字数を単位として数え、金額は計算しません。メンションの取り込みとトリアージでは、ディスパッチコストは記録されません。 dryRun: true を指定しない場合、SDK のディスパッチは実行されます。実際にディスパッチするたびにプレビューし、ガードが拒否した場合は停止してください。

統合ガイド

• Node.js のメンションキューの例
• CLI と MCP コマンドのリファレンス
• 汎用 Webhook 入力の動作

下流の AI ワークフローから公開するコンテンツには、適切な AI であることの開示を含める必要があります。

ステータス

バージョン 0.1.0 は初期段階のため、インターフェースは変更される可能性があります。このリポジトリでは、一般公開されている導入事例はまだありません。 サポートについては、GitHub のイシューをご利用ください。

FAQ

agentic-mentions はソーシャルネットワークのコメントを収集しますか？

agentic-mentions は、ユーザーが提供するレコードを受け付けます。ソーシャルネットワーク API コネクターはありません。

検証済みのインテグレーションはどれですか？

agentic-mentions では、汎用入力とルーティングの経路についてローカルテストを実施しています。このリライトでは、認証情報を使用した外部サービスの検証は行っていません。

agentic-mentions はマネージドのリスニングサービスを提供しますか？

agentic-mentions はユーザー自身のプロセスで動作します。収集、ホスティング、永続化はユーザーが用意してください。

agentic-mentions は Natural とどう違いますか？

agentic-mentions は、メンションレコード、重複排除、処理状態を追加します。Natural は、より幅広い自然言語処理のプリミティブを提供します。

agentic-mentions は Sentiment とどう違いますか？

agentic-mentions は、意図、緊急度、ルートの判定に固定ルールを使用します。Sentiment は、単語リストに基づくセンチメントスコアを算出します。

agentic-mentions は返信を送信しますか？

agentic-mentions はルートを提案するだけです。その後の動作は、アプリケーションが決定します。

再起動後もキューは保持されますか？

agentic-mentions のデフォルトストアはメモリ上に保持されます。再起動後に復元する必要がある場合は、アプリケーションでレコードを永続化してください。

コストレポートでは何を測定しますか？

agentic-mentions は、成功したコアディスパッチの回数と文字数単位を数えます。通貨は測定せず、トリアージに料金はかかりません。

ライセンス

MIT。