AI代理身份验证SDK

Badge为AI代理提供跨商户站点的持久身份验证,使代理能够积累信用并获得更好的服务待遇。

  • by kyalabs-Io
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 payclaw/badge-server

使用说明

kya-labs徽章

跨商家网站的AI代理的持久身份。徽章为代理商提供了他们在每次请求时都会携带的凭证——商家会对其进行验证,信任会在每次访问中积累,建立历史的代理商会随着时间的推移获得更好的待遇。

框架无关。交通不可知。零运行时依赖关系。


徽章SDK

SDK是主要的集成界面。三种方法涵盖了整个生命周期:

import { Badge } from "@kyalabs/badge-sdk";

const badge = await Badge.init();
const runId = badge.startRun();

await badge.declareVisit({
  merchant: "store.example.com",
  runId,
  url: "https://store.example.com/cart",
});

await badge.reportOutcome({
  merchant: "store.example.com",
  runId,
  outcome: "not_denied",
});

没有注册。没有API密钥。 Badge.init() 在第一次运行时发出访客通行证并将其缓存到磁盘。身份在进程重启后仍然有效。

npm install @kyalabs/badge-sdk

完整的SDK文档→

SDK涵盖了什么

  • 身份模型 --三层梯子:客人通行证(gp_v1_*) → 徽章令牌(kya_*) → 经过身份验证的身份
  • 生命周期跟踪 --声明访问、报告结果、与运行ID关联
  • 线下弹性 --永不引发网络故障,每次呼叫都有确定性回退
  • UCP集成 — io.kyalabs.common.identity 凭证提供程序、已发布的模式、ES256签名的JWT
  • 评分 --结果反馈kyaScore(500-850),可在商家之间移动

MCP服务器徽章

对于MCP客户端用户(Claude Desktop、Cursor、Windsurf),Badge也作为MCP工具服务器提供。MCP服务器封装了SDK——相同的身份模型、相同的令牌、相同的评分。

npx @kyalabs/badge

SDK是平台构建者和代理框架的规范集成路径。MCP服务器是在MCP客户端内工作的最终用户的便利包装器。


链接

许可证

麻省理工学院