SuperAPI AI 工具集

humanrail-escalation

部署与运维

查看项目

更新于 10-15 17:21

技能介绍

用途:为自动化智能体提供人工介入升级通道,把低置信度决策、破坏性操作审批、模糊事件工单分诊交给外部真人工程师判断。

主要能力:通过 HumanRail MCP 服务器(来源 prime001/humanrail-mcp-server,Streamable HTTP,默认端口 8100,Python 3.10+)提供 7 个工具:create_task、get_task、wait_for_task、cancel_task、list_tasks、get_usage、health_check。支持任务类型如 technical_decision、change_approval、incident_triage,可指定 output_schema、risk_tier、sla_seconds、payout 等。

使用方式:本地安装依赖 pip3 install "mcp[cli]>=1.0.0" httpx,然后 HUMANRAIL_API_KEY=ek_live_your_key python3 $HUMANRAIL_MCP_SCRIPT 启动;也可直接用公共端点 https://humanrail.dev/mcp,无需本地安装。需设置 HUMANRAIL_API_KEY 与 HUMANRAIL_MCP_URL,可选 HUMANRAIL_MCP_SCRIPT、HUMANRAIL_BASE_URL。典型流程为创建任务、wait_for_task 轮询、仅在 status == "verified" 后按输出行动。

适用场景:智能体置信度低且存在多种合理解释;超出常规 ITSM 门禁的破坏性操作(如设备重载、BGP 邻居拆除、ISE 策略清除);信息不足的事件工单分诊;P1/P2 需即时人工判断。

限制与规则:不得向外部人员暴露内部工具、主机名、路径或凭据,任务描述须中性脱敏;不得用其替代 ServiceNow 变更管理,破坏性操作仍需 CR 处于 Implement 状态;不得在载荷中暴露 PII、设备凭据或配置密钥;仅在 verified 状态后行动;超时或失败应回退保守方案并创建事件。可与 servicenow-change-workflow、ise-incident-response、slack-incident-workflow、gait-session-tracking、pyats-config-mgmt 集成。