NN Agent的结构:客户端、账户、活动、对话
NN Agent操作六个实体。它们在仪表板和API中是相同的,因此本页面中的名称在屏幕和请求地址中都会出现。
客户和许可证#
客户 — 您在 NN Agent 中的账户,绑定了账户、活动和联系人。客户在 Telegram 机器人中验证时创建,并为其发布访问 API 的令牌。
许可证 定义了您有多少个活动槽位以及到期时间。许可证通过代码激活并续期;在 API 中,这是一个单独的操作组 — GET /v2/client/licenses, POST /v2/client/licenses/activate, POST /v2/client/licenses/renew。
账户#
账户 — 连接的消息应用账户,NN Agent 以该账户的名义进行写作和阅读。账户有其 UUID 格式的标识符、名称和照片;对客户端而言,这就是一个普通人,而不是机器人。
账户可以有很多:它们会同步到一个流中,无需在聊天之间切换。更多信息 — 多账户管理。
授权会话#
授权会话 — 一个临时对象,存在的时间正好与账户连接的时间相同。您创建它,消息应用发送代码,您将代码发送到会话中,如有必要,还可以发送云密码,之后账户就会连接。
会话有自己的 UUID,与账户标识符不同。还有一种使用二维码代替消息中的代码的选项。
活动#
活动 — 外发邮件:一组联系人、一组初始消息的选项和发送这些消息的关联账户。一个账户可以参与多个活动,反之亦然。
活动将其联系人单独存储,因此一个活动的数据库不会与另一个活动的数据库混合。
消息池#
消息池 — 活动的初始消息选项列表。NN Agent 从中获取文本以进行下一个联系,因此整个数据库不会收到相同的字符文本。
消息池可以逐个填充或通过上传填充;单个元素可以通过标识符删除。
联系与对话#
联系 — 在公司数据库中的记录:谁将要写。联系人通过CSV或XLSX文件上传,并以相同的格式导出。
对话 — 您的账户与特定对话者之间的通信。对话通过“账户 + 对话者标识符”这一对进行寻址,并在同一对中读取消息和发送新消息。
这如何相关#
客户拥有账户和活动。活动持有联系人和消息池,并依赖于与之关联的账户。通过活动发送会产生对话,AI会根据您的场景继续进行。