Back to Details

skyfire

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

When to use

使用场景

Use this skill when:
  • Building agent workflows that require identity and/or payment tokens
  • Creating buyer tokens (
    kya
    , 
    pay
    , 
    kya+pay
    ) via REST or Skyfire MCP
  • Accepting tokens on seller APIs and charging payment-capable tokens
  • Defining or updating seller service metadata and token requirements
  • Discovering services and tags from Skyfire service directory APIs
  • Managing enterprise users and agent settings via admin endpoints
在以下场景中使用本技能：
  • 构建需要身份和/或支付令牌的Agent工作流时
  • 通过REST或Skyfire MCP创建买方令牌（
    kya
    、
    pay
    、
    kya+pay
    ）时
  • 在卖方API上接收令牌并对具备支付能力的令牌进行扣费操作时
  • 定义或更新卖方服务元数据与令牌要求时
  • 从Skyfire服务目录API中发现服务和标签时
  • 通过管理端点管理企业用户与Agent设置时

Quick Start

快速开始

  1. Use 
    https://api.skyfire.xyz
    and send 
    skyfire-api-key
    on authenticated endpoints.
  2. Use 
    https://mcp.skyfire.xyz/mcp
    with 
    skyfire-api-key
    for MCP workflows.
  3. Pick token type by operation: 
    • kya
      : identity-only
    • pay
      : payment-only
    • kya+pay
      : identity + payment
  4. Pass buyer token to seller service in 
    skyfire-pay-id
    (recommended by Skyfire docs).
  5. For seller charging and balance checks, use token introspection and charge endpoints.
  1. 使用
    https://api.skyfire.xyz
    ，并在已认证的端点上携带
    skyfire-api-key
    。
  2. 对于MCP工作流，使用
    https://mcp.skyfire.xyz/mcp
    并携带
    skyfire-api-key
    。
  3. 根据操作选择令牌类型： 
    • kya
      ：仅身份验证
    • pay
      ：仅支付
    • kya+pay
      ：身份验证+支付
  4. 在
    skyfire-pay-id
    中传递买方令牌（Skyfire文档推荐方式）。
  5. 对于卖方扣费和余额查询，使用令牌introspection与扣费端点。

Workflow Routing

工作流指南

1. Platform and Authentication

1. 平台与身份验证

  • Set Up API Keys and Environment
  • 设置API密钥与环境

2. Buyer Token Creation Patterns

2. 买方令牌创建模式

  • Choose the Right Token Type
  • Create Buyer Tokens Correctly
  • Enforce Token Creation Constraints
  • 选择合适的令牌类型
  • 正确创建买方令牌
  • 执行令牌创建约束

3. Seller Token Acceptance and Charging

3. 卖方令牌接收与扣费

  • Validate, Introspect, Charge, and Reconcile Seller Payments
  • Verify JWT Claims with JWKS
  • Handle Missing or Invalid Tokens Consistently
  • 验证、Introspect、扣费与核对卖方付款
  • 通过JWKS验证JWT声明
  • 统一处理缺失或无效令牌

4. Seller Service Management

4. 卖方服务管理

  • Manage Seller Service Lifecycle (CRUD)
  • 管理卖方服务生命周期（CRUD）

5. Discovery and Agent Operations

5. 发现与Agent操作

  • Discover Services and Tags
  • Use Wallet, Source IP, and Token Version APIs
  • 发现服务与标签
  • 使用钱包、源IP与令牌版本API

6. MCP Integration Patterns

6. MCP集成模式

  • Integrate Skyfire MCP in Agent Workflows
  • 在Agent工作流中集成Skyfire MCP

7. Enterprise Operations

7. 企业操作

  • Manage Enterprise Users and Personal Data
  • 管理企业用户与个人数据

8. Security and Reliability Patterns

8. 安全与可靠性模式

  • Apply Skyfire Security Best Practices
  • 应用Skyfire安全最佳实践

References

参考资料