mcpField
W
wazoo

wazoo

github.com/wazootech数据与数据库014 次安装4 周前更新
代码仓库

关于 wazoo

Wazoo Skill 提供管理 Wazoo 知识图谱 world 和访问令牌的命令示例，也说明如何导入、搜索、查询和导出图数据，以维护 Agent 的持久上下文。

主要功能

  1. 01列出、创建、更新和删除 world
  2. 02管理平台与 world 令牌
  3. 03导入图数据
  4. 04搜索 world 上下文
  5. 05运行 SPARQL 并导出图数据

适用场景

  1. 01为项目上下文创建 world
  2. 02将文本或 RDF 四元组导入图记忆
  3. 03搜索已存上下文或执行图查询
  4. 04为审计或备份导出数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wazootech/wazoo-skills --skill wazoo

安装后在 Claude Code 中输入/wazoo确认已加载。

详细介绍

Wazoo 技能

在与 Wazoo 平台交互、管理知识图谱世界、查询结构化记忆或维护持久 Agent 上下文时，请使用此技能。

环境设置

Wazoo 使用两种令牌类型：

  • WAZOO_PLATFORM_TOKEN（wzp_...）：用于控制平面管理（世界、令牌、用量、账单）。
  • WORLDS_TOKEN（wzw_...）：用于数据平面操作（导入、搜索、SPARQL、导出）。
export WAZOO_PLATFORM_TOKEN="wzp_..."
export WORLDS_TOKEN="wzw_..."

1. 控制平面管理

列出世界
curl -s -X GET "https://api.wazoo.dev/v1/worlds" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
创建世界

使用显示名称创建世界。worlds-api 会生成一个不可变的 w_<ULID> ID。创建请求包含显示名称和可选的区域字段，不包含由调用方指定的 ID 或 slug 字段。响应会将 ID 显示为 world.id； 请原样复用该 ID 作为 WORLD_ID。

curl -s -X POST "https://api.wazoo.dev/v1/worlds" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "world": { "displayName": "Project Context Graph", "region": "auto" }
  }'

对于以下示例，请将此示例值替换为上方返回的 id：

export WORLD_ID="w_01jd8x5mqv7k3n9r2t4w6y8z0b"
获取世界详情
curl -s -X GET "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
更新世界
curl -s -X PATCH "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "updateMask": "displayName",
    "world": { "displayName": "Project Context Graph v2" }
  }'
删除世界
curl -s -X DELETE "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
恢复已删除的世界

删除是软删除，可恢复。使用 undelete 恢复已删除的世界：

curl -s -X POST "https://api.wazoo.dev/v1/worlds/$WORLD_ID/undelete" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"

2. 令牌管理

列出平台令牌
curl -s -X GET "https://api.wazoo.dev/v1/auth/api-tokens" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
创建平台令牌
curl -s -X POST "https://api.wazoo.dev/v1/auth/api-tokens" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent-token",
    "scope": "users.read worlds.read usage.read"
  }'
撤销平台令牌
curl -s -X DELETE "https://api.wazoo.dev/v1/auth/api-tokens/my-agent-token" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
列出世界令牌
curl -s -X GET "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
创建世界令牌

世界令牌限定于单个世界，用于数据平面访问：

curl -s -X POST "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "ci-data-access" }'
撤销世界令牌
curl -s -X DELETE "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens/{tokenUid}" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"

3. 数据平面操作

导入图数据

将 RDF 四元组（JSON 数组）或分块文本导入世界：

curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/import" \
  -H "Authorization: Bearer $WORLDS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contentType": "text/plain",
    "data": "Architectural Decision Record 001: Use hybrid SPARQL and vector search for durable memory."
  }'
跨上下文混合搜索

按查询文本搜索世界图谱记忆：

curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/search" \
  -H "Authorization: Bearer $WORLDS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Architectural Decision Record",
    "limit": 5
  }'
执行 SPARQL 查询

在世界中的三元组/四元组上运行图查询：

curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/sparql" \
  -H "Authorization: Bearer $WORLDS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10"
  }'
导出图数据

导出世界四元组，用于审计或本地备份：

curl -s -X GET "https://data.wazoo.dev/worlds/$WORLD_ID/export?format=application/json&limit=100" \
  -H "Authorization: Bearer $WORLDS_TOKEN"

评论

支持 Markdown