agentic-mentions

agentic-mentions

快速开始 · API 和命令 · 软件包

agentic-mentions 是一款开源提及内容分流工具包，面向接收外部评论的开发者。 它会对记录去重，并应用文本规则分析情感、意图、紧急程度和建议路由。 Node.js 库、CLI 和 Model Context Protocol（MCP）服务提供了这套工作流。

安装

npm install agentic-mentions

需要 Node.js 18 或更高版本。包含 TypeScript 声明和两个运行时依赖项。

分流你的第一条提及内容

本地分流无需凭据或环境变量。

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);

结果具有严重紧急程度，并建议升级处理。两个示例都不会发送回复。

工作原理

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

项目缘起

提及内容工作流除了文本标签，还需要记录去重和处理状态。 Natural 和 Sentiment 提供文本分析基础功能。本软件包将固定规则与本地队列和 Agent 工具结合起来。

比较

于 2026-10-14 对照 Natural 的源代码和 Sentiment 的源代码进行了检查。 这些是本地文本分析替代方案，并非托管式社交监听服务。

范围	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} 发送到提供的端点
社交网络 API	—	没有特定品牌的连接器

源代码清单包含两个提及内容适配器和两个路由适配器。本地测试会验证这些路径；不会验证外部服务凭据。 通用 webhook 适配器是解析器和获取客户端，并非监听 HTTP 服务器。

常见用例

1. 支持开发者使用 Node.js，按紧急程度排列提供的投诉记录。
2. 社区团队使用 JSON 导出文件和 CLI 预览分流标签。
3. Agent 开发者使用 MCP 客户端导入记录并查看会话队列。
4. 后端开发者使用 Node.js 和通用 JSON 端点规范化 webhook 记录。

功能

• **去重：**指纹会根据同一存储中的账户、作者和规范化文本生成。
• **分流：**规则会分配情感、五种意图、四个紧急程度级别和三种路由建议。
• **队列：**未处理记录按紧急程度排序，其次按创建时间戳排序。
• **处理状态：**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。 四个提及命令的 mentions 前缀可选。处理提及必须使用 --live 才会改变状态。

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

stdio 服务恰好公开四个工具：ingest_mentions、triage_mention、mention_queue 和 mark_mention_handled。 默认情况下，处理提及只会生成预览。设置 live: true 可将其标记为已处理；注入的审批回调可以拒绝该操作。 默认回调会批准。这不是交互式审批提示。

构建后的 Worker 入口提供 GET /health 和接收 JSON text 字符串的 POST /summarize。 它提供文本统计信息，而不负责提及导入。请自行部署；它既不是托管服务，也不是包根目录导出项。

交付与行为限制

存储和成本报告都保存在内存中。不同的 CLI 调用会从全新状态开始；导入命令不会让后续队列数据持久化。 规则使用固定的英文关键词。它们无法理解上下文、讽刺或所有语言。 该包会建议回复、忽略或升级处理；它不会发送回复，也不会自动收集社交网络提及。 HTTP 路由器的默认超时时间为十秒，且未配置重试或身份验证。 调度成本以字符数为单位，而非货币。提及导入和分类不会记录调度成本。 除非提供 dryRun: true，否则 SDK 调度会实际执行。每次实际调度前都应先预览，并在防护机制拒绝操作时停止。

集成指南

• Node.js 提及队列示例
• CLI 和 MCP 命令参考
• 通用 Webhook 输入行为

下游 AI 工作流生成的任何可发布内容都必须附带适当的 AI 披露声明。

状态

0.1.0 版本尚处早期阶段；接口可能会更改。本仓库尚未发布公开案例研究。 如需支持，请使用 GitHub issues。

常见问题

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。