使用说明
kya-labs——AI代理的徽章+支出
你的代理人不是机器人。kya证明了这一点，然后让它付钱。
对于互联网上的每个商家来说，你的人工智能代理看起来都像一个机器人。kya给出了两件事：
徽章 --将您的代理人声明为授权演员。用于商家握手的通用商务协议“身份”令牌。免费。无需卡片。
花费 --当您的代理人需要付款时，签发一次性虚拟签证。人类认可。使用后自毁。你的真卡永远不会进入聊天。
如果你和去年20%的美国人一样，你会找经纪人购物。你可能会遇到很多登录墙、变通方法、颠簸？
我们也是。因此，我们创建了kya——第一个与新的通用商务协议配合使用的MCP工具套件，可以在支持商家（Shopify、Target、沃尔玛、Etsy……很多）轻松地与经过验证的代理握手。身份徽章。为付款而支出。
🧪 开发者沙盒已打开。 真正的基础设施，测试资金。 获取沙盒访问权限→
快速开始
npx @kyalabs/mcp-server
或者添加到您的MCP客户端配置中（Claude Desktop、Cursor或任何MCP客户端）：
{
"mcpServers": {
"kyalabs": {
"command": "npx",
"args": ["@kyalabs/mcp-server"]
}
}
}
就是这样。Badge立即生效-无需API密钥，无需注册，安装时无需网络调用。
你的经纪人第一次打电话来 kya_getAgentIdentity，它向商家声明自己，并收到回复 next_step 指导。记录了一个匿名事件。你的代理人现在是一名正式授权的演员。
或通过ClawHub安装：
clawhub install payclaw-io
升级到验证模式+消费
对于加密身份和虚拟卡发行，请添加API密钥：
"env": {
"KYA_API_KEY": "pk_live_your_key_here",
"KYA_API_URL": "https://www.kyalabs.io"
}
获取API密钥： kyalabs.io/signup.API密钥不会过期。
在没有API密钥的情况下，当商家需要验证身份时，Badge使用设备身份验证-您的代理显示代码和URL，您在手机上批准。这只发生在商人要求的时候。我们自己从不要求。注册+API密钥意味着1。你不必每次都使用电话OAuth。您可以跟踪您的代理购物（包括自定义头像）
节点版本
kya MCP要求 Node.js 20或更新版本节点18已结束生命周期，不受支持。
如果您看到引擎或兼容性错误： node -v --从以下位置安装节点20+ nodejs.org 或 nvm install 20
徽章的工作原理：两种模式
已声明（默认）
当您的代理首次使用Badge前往商家时，Badge会生成一个匿名安装ID——一个随机UUID，存储在本地 ~/.kya/install_id。它与您、您的设备或任何个人信息无关。
你的代理人会收到一份申报单和一份 next_step 引导其向商家报告其徽章展示情况。
这是默认模式。Badge就是这样开箱即用，永远为每个用户服务的。
已验证（当商家要求时）
当商家要求验证身份时——他们的UCP清单上写着 required: true --您的代理将要求您批准设备流。您访问一个商家kya URL，从您的代理输入OAuth代码，并证明您是一个真实的人。
Badge发出一个标记化的凭证：一个ES256签名的JWT，由kya的私钥签名，可由商家在本地验证。您的代理可以自由继续-无需登录、PII或任何所需信息。
我们的数据哲学
| 何时 | 什么 | 为什么 |
|---|---|---|
| 安装时 | 没什么 | 我们帮代理商购物。如果他们不购物，我们什么都不需要 |
| 服务器启动时 | 匿名ping——徽章版本和MCP客户端名称。您的计算机上没有存储标识符 | 因此我们知道Badge正在运行。如果这个数字与活跃的代理人有所不同，它会告诉我们一些事情正在酝酿中，而不是你的一些事情 |
| 首次购物之旅 | install_id（随机UUID，存储在本地 ~/.kya/install_id)，商户，代理类型，事件类型，时间戳 |
减少商户代理摩擦的最小可行信号 |
| 关于已验证的身份 | +散列用户令牌、意图范围（签出等） | 仅在传统上需要登录（即签出）以证明有真人授权代理的下一步时才需要 |
| On Spend（发卡） | +完整的交易追踪：意图、金额、商家、审计日志 | 卡网络合规性、同意后门控+MFA |
服务器开始ping不包含持久标识符——会生成一个新的随机会话ID 每次都不会保存到磁盘。您可以完全禁用它：
"env": { "KYA_PING": "false" }
install_id是我们写入您磁盘的文件。您可以删除它(rm ~/.kya/install_id)然后买一个新的。
完整的数据实践： 凯拉伯斯岛/信托
通用商业协议
徽章是一种 UCP（通用商业协议） 凭据提供程序。向每个符合UCP的代理商声明kya身份扩展信号的商家表示，授权代理商在他们的商店是首选。
当您的代理遇到安装了徽章的UCP商家时，它会自动显示加密徽章，无需额外步骤。
我们相信UCP是商业的未来，并为支持代理商和用户减少摩擦而感到自豪。
- 扩展规范+架构： github.com/kyalabs/ucp-agent-badge
- 阅读更多关于UCP的信息： github/通用商业协议/ucp
没有kya： 代理浏览→ 机器人探测火灾→ 此 路 不通。即使它通过了，没有你的真实卡号也无法结账。你只能手动完成。
带徽章： 代理人声明自己是授权演员→ 商家看到经过验证的身份→ 特工通过了。没有旁路。只是证据。
与支出： 代理人宣布购买→ 您只需点击一下即可批准→ kya向该商户发放锁定的一次性虚拟Visa卡→ 代理人退房→ 卡片自毁。你的真卡永远不会进入聊天。
你的代理人会知道什么时候需要这个。当它遇到可能挑战自动流量的商家时，或者当它准备结账时，它会告诉你：“我需要安装kya来完成这项工作。”你点击允许。完成。
工具
看 docs/tool-controll.md 对于正式的输入/输出合同。
| 工具 | 它做什么 |
|---|---|
kya_getAgentIdentity |
声明身份→ 获取验证令牌+ next_step 指导（徽章） |
kya_reportBadgePresented |
记录您在商家处出示徽章的情况 |
kya_reportBadgeOutcome |
报告商家的反应（接受、拒绝、不确定） |
kya_reportBadgeNotPresented |
报告您没有出示徽章（被遗弃，商家没有问） |
kya_getCard |
声明购买意向→ 获得虚拟签证（消费） |
kya_reportPurchase |
报告交易结果→ 关闭审计跟踪 |
每次Badge工具调用都会立即生效，无需身份验证。事件以匿名和验证模式触发。
徽章：声明身份
Agent → kya_getAgentIdentity({ merchantUrl })
kya → browse_declared event fires automatically
kya → verification token + next_step + checkoutPatch (if merchant supports UCP)
Agent → merges checkoutPatch into checkout payload
Agent → kya_reportBadgePresented({ merchantUrl, verification_token })
Agent → kya_reportBadgeOutcome (accepted | denied | inconclusive)
消费：获得一张卡
Agent → kya_getCard (merchant, amount, description)
User → approves via MFA
kya → issues single-use virtual Visa
Agent → uses card at checkout
Agent → kya_reportPurchase (closes audit trail)
Card → self-destructs
一个任务。一个批准。一张卡片。完成。
扩展身份验证（可选）
启用后，kya会在每次出示徽章后7秒与您的代理进行核对，以确认商家是接受还是拒绝。结果会记录到您的仪表板上，这样您就可以看到何时以及哪些商家拒绝了您的代理。
"env": {
"KYA_EXTENDED_AUTH": "true"
}
授权如何扩展
| 行动 | 发生了什么 |
|---|---|
| 浏览 | 徽章声明——发放身份证 |
| 搜索 | 徽章声明——发放身份证 |
| 结账 | 徽章+消费——MFA批准→ 签发一次性签证 |
浏览需要声明。花钱需要声明+明确的意图+明确的人类批准+一张使用后自毁的短暂卡片。
为什么选择kya-labs
| 将您的卡交给代理人 | 加密钱包 | 什么 | |
|---|---|---|---|
| 已声明代理身份 | 否 | 否 | 每次会议 |
| 每次购买都需要人工批准 | 否 | 否 | 每次购买 |
| 卡凭证寿命 | 永久 | 永久 | 一次性使用 |
| 在现有商家工作 | 是 | 否 | 是--签证栏 |
| 您的真实卡已暴露 | 是 | 不适用 | 从不 |
只有徽章？
如果您只需要身份（无需付款），请使用较轻的包装：
npx @kyalabs/badge
新增功能（v2.3）
| 能力 | 描述 |
|---|---|
assurance_level |
现在，每次旅行都有一个信任分数(starter → elite)来源于象征性的内省。在您的仪表板中可见，并包含在所有行程结果事件中。 |
| 商户信号感知 | kya_getAgentIdentity 现在检测商家是否具有活动的kya信号基础设施(window.__kya_commerce、元标签、llms.txt）。返回为 merchant_signals 在身份结果中。 |
| 匿名优先 | 徽章在安装时有效。没有身份验证，没有注册，安装时没有网络。第一 kya_getAgentIdentity 呼叫火灾 browse_declared 自动。 |
| 扩展分支 | 匿名事件在没有身份验证的情况下触发。验证的事件包括完整的用户上下文。没有沉默的门。 |
next_step field |
每个身份响应都包括对代理下一步行动的指导。当虚拟卡可用时，请注意消费。 |
KYA--了解你的经纪人
kya是kya的基础设施。每个声明都会创建一个经过验证的代理商业行为记录，建立信任信号，让商家能够区分授权代理和匿名机器人。
链接
- 网站： 凯拉伯斯岛
- npm： @kyalabs/mcp服务器
- 徽章npm： @卡拉布/徽章
- UCP扩展： github.com/kyalabs/ucp-agent-badge
- ClawHub： payclaw io
- 信任： 凯拉伯斯岛/信托
- 商家： kyalabs.io/吸收剂
- 联系人： agent_identity@kyalabs.io
特工不是机器人。kya实验室证明了这一点。 你的真卡永远不会进入聊天。
