assetcorelistcontainers

AssetCore هو قاعدة بيانات ذاكرة هيكلية حتمية. يخزن جميع حالات العالم بشكل صريح في حاويات ويعدل تلك الحالة من خلال معاملات ذرية قابلة لإعادة التشغيل. قم بتعداد الحاويات مع مرشحات المالك/النوع والتصفح لتخطيط استعلامات القراءة.

التفاصيل

يتصل /v1/read/namespaces/{namespace_id}/containers مع مالك اختياري (u32)، نوع (balance|grid|slots|continuous_line_1d|continuous_grid_2d)، مؤشر (معرف الحاوية الأخيرة التي تم رؤيتها)، وحد limite (افتراضي 20، أقصى 200). القيم التي تتجاوز الحد الأقصى يتم تقليصها إلى الحد الأقصى. تعيد limit/next_cursor/has_more بالإضافة إلى إدخالات containers[] (container_id، kind Balance{quantization_inv}|Grid{capacity،grid_width؟}|Slots{count}|ContinuousLine1d{min_x,max_x,quantization_inv,bucket_cell_size؟}|ContinuousGrid2d{min_x,min_y,max_x,max_y,quantization_inv,bucket_cell_size؟}، owner؟، display_name؟) جنبًا إلى جنب مع معرفات النضارة والترابط. استخدم next_cursor كمعامل المؤشر لطلب الصفحة التالية.

البروتوكولات

MCP
أوبن أيه آي
جمني

مخطط الإدخال

{
  "properties": {
    "cursor": {
      "description": "Cursor anchored to the last seen container identifier.",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    },
    "kind": {
      "description": "Filter by container kind (balance|grid|slots|continuous_line_1d|continuous_grid_2d)",
      "enum": [
        "balance",
        "grid",
        "slots",
        "continuous_line_1d",
        "continuous_grid_2d"
      ],
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of containers to return (default: 20, max: 200)",
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    },
    "namespace_id": {
      "description": "Required namespace identifier for all namespaced operations.",
      "minimum": 1,
      "type": "integer"
    },
    "owner": {
      "description": "Filter containers by owner identifier.",
      "maxLength": 128,
      "minLength": 1,
      "pattern": "^[A-Za-z0-9._~\\-]+$",
      "type": "string"
    }
  },
  "required": [
    "namespace_id"
  ],
  "type": "object"
}

أمثلة

لا توجد أمثلة متاحة حاليًا لهذه الأداة.