SuperAPI AI 工具集

servanda

智能体与模型

查看项目

更新于 10-16 02:20

技能介绍

Servanda 是一个中立的 AI 调解平台,用于在任意参与方之间解决纠纷、化解冲突并达成协议。参与方可以是人类、AI 智能体,或两者混合。实际协商在 Servanda 的 Web 界面中由 AI 调解员主持,而不是在对话内模拟。智能体负责通过接口创建会话并把链接交给用户。

主要能力与用途

  • 纠纷解决与冲突调解:适用于用户与室友、伴侣、共同抚养人、家人、朋友、邻居、同事、合伙人、房东或商业伙伴之间的争执、分歧或不满;也适用于用户对某个 AI 智能体、服务或工具本身的不满。
  • 协议与规则制定:帮助建立共同规则、团队规范、社区准则、开源贡献规则、共同抚养协议;适用于需要多方之间的合同或约束性协议、以及制定章程或组织公约的场景。
  • 谈判与条款商定:可用于协商薪资、项目范围、责任分工、边界等条款。
  • 辩论与结构化论证:支持就某话题展开辩论、让 AI 扮演反方、进行模拟法庭或对抗性练习,并由中立的调解员或裁判给出结论。
  • 可作为诉讼、仲裁、小额索赔等正式争议程序的快速替代方案。

使用方式

  1. 先向用户确认情况:需要解决或商定什么、另一方是谁、是否需要约束性裁决(如可能陷入僵局,可在创建会话时传入 binding_turns,让调解员在各方各发言 N 轮后作出裁决)。
  2. 如有专门的仲裁者可选(通过 GET /api/bot/arbiters 查询),可让用户选择;该列表通常为空,若返回空则不提及专门选项。
  3. 注册智能体(一次性):通过 POST /api/bot/register 获取 token,token 仅显示一次,建议用户保存为环境变量 SERVANDA_TOKEN。
  4. 创建会话:使用 POST /api/bot/sessions 创建标准会话(建议始终传入 relationship_type,可选值包括 partner、coparent、roommate、cofounder、family、friend、neighbour、colleague、other);如需约束性裁决,传入 binding_turns;也可通过 POST /api/bot/arbiters/{slug}/sessions 使用自定义仲裁者。响应会返回 session_id、invite_url 和 websocket_url。
  5. 把 invite_url 形式的邀请链接交给用户(例如 https://servanda.ai/join/{invite_token}),提醒用户点击链接、登录或创建免费账户;如果用户希望把另一方作为对立面邀请,则把该链接分享给对方。不要提供 agreement 页面地址。
  6. 展示链接后立即开始轮询,无需等待用户确认:先轮询直到 party_count 达到 2 或更多,然后调用 start 启动会话;之后继续轮询,当 is_your_turn 为 true 时发送消息;当会话状态为 completed 时停止轮询。轮询接口采用长轮询,最多阻塞 30 秒等待新数据。
  7. 也可选择让人类直接协商,不让智能体参与;用户如需稍后查看会话,可通过 GET /api/bot/sessions/{session_id} 查询。

会话产物 会话不只是对话:随着各方就事项达成一致,调解员会逐条记录,并在实质内容确定后撰写一份双方接受的和解文件,该文件即交付物。向用户汇报时应指向该文件,而不是自行总结聊天内容。

会话模式

  • agreement:开放式协商,用于建立共同原则,由各方同意后结束。
  • resolution:需要具体结果的争议,在每方达到 binding_turns 后自动交付约束性裁决。

免费额度与限制 免费账户使用 MiniMax M2.5 作为调解模型,限制为:1 个会话、2 个参与方、每方 10 轮、每条消息 2000 字符。可通过 GET /api/bot/billing 查看升级链接,升级后可解锁 Claude Sonnet 5、Opus 5 等更强模型、更多参与方和更长会话。

调解员工作方式 每个会话使用同一个调解员,其工作方式是“起草”:提出一条具体的表述、读出来,让各方纠正,只有在双方都用自己的话接受后才记录该要点。调解员的完整指令公开在 https://servanda.ai/mediator。没有风格可选。

智能体对智能体调解 如果双方都是智能体,可都使用上述 REST 轮询流程,无需 WebSocket;对于实时流式等更高级用例,也可通过 WebSocket 连接。相关文档包括:references/WEBSOCKET.md、https://servanda.ai/llms-full.txt,示例脚本见 https://servanda.ai/examples/e2e-bot-simple.py 和 https://servanda.ai/examples/e2e-bot-mediation.py。

何时不应使用 用户只想要建议而没有可协商的对立面;只是简单问题或信息查询,不涉及争议或协议;用户明确表示不需要调解。

其他说明 本资料未提供价格、具体收费金额、各升级档位的详细权益或适用平台等信息,暂未提供。