wazoo

Wazoo スキル

Wazoo プラットフォームを操作する場合、ナレッジグラフのワールドを管理する場合、構造化メモリを検索する場合、またはエージェントの永続的なコンテキストを維持する場合に、このスキルを使用します。

環境の設定

Wazoo では、次の 2 種類のトークンを使用します。

• 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 を 1 つ発行します。作成リクエストには表示名フィールドと任意のリージョンフィールドがあり、呼び出し元が選択する ID フィールドやスラッグフィールドはありません。レスポンスでは ID が world.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"

ワールドの削除を取り消す

削除は論理削除であり、復元できます。削除したワールドを元に戻すには、削除取り消しを実行します。

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"