Capability Marketplace
能力质量说明
了解 Xenodia 已发布能力向用户提供的信息和使用保障。
每项已发布能力都会提供足够的信息，让用户或 Agent 能判断是否调用，以及如何通过 Xenodia 安全调用。
公开信息
| 字段 | 含义 |
|---|---|
slug | Xenodia 公开路径使用的稳定标识。 |
name | 能力目录显示的名称。 |
category | 能力支持的任务类型。 |
short_description | 能力用途的简要说明。 |
default_version | 当前公开的 API 版本。 |
funding_modes | 支持的支付关系。 |
invoke_path | 默认操作的 Xenodia 公开路径。 |
operations | 可用操作、输入、输出与价格。 |
agent_doc_what | Agent 应在什么情况下选择该能力。 |
agent_doc_how | 推荐调用顺序与安全规则。 |
trust_signals | 证据、新鲜度、可用性、幂等或审计信号。 |
操作信息
每个操作都会说明 Xenodia 请求方法与路径、用途、价格、输入字段、最小请求示例、预期输出、执行模式，以及是否要求 Idempotency-Key。
版本与兼容
已发布的 slug 和路径保持稳定。如需引入不兼容的请求或响应变化，Xenodia 会发布新版本，并在适用时保留已说明的兼容路径。
描述、标签、示例和使用建议可以持续完善，而不改变现有版本的行为。
价格与安全
价格使用 unit_price_micro_usdc，其中 1000000 等于 1 USDC。包含多个操作的能力会在调用前分别展示各操作价格。
调用付费操作前，请确认：
- 操作当前可用。
- 当前价格和支付方式符合预期。
- 请求符合公开的输入格式。
- 只有重试同一笔付费或异步请求时，才复用同一个
Idempotency-Key。 - 保留返回的请求编号和计费摘要，以便查询与审计。
用户能力目录只包含选择、调用、计价、重试和核对能力所需的信息。