SosoAPI
AR
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
تسجيل الدخول

يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

أداة MCP

تسوية نتيجة تسليم التعليق

sosoapi_reconcile_comment_outcome

التحقّق من تسليم Facebook غامض دون إعادة إرسال، أو ربط بديل مطابق واحد مؤكّد. افحص outcome للدليل النهائي.

اقرأ بصيغة Markdown

الملفات التعريفية ووسائل النقل

الملفات التعريفية: full · وسائل النقل: stdio, http

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

حقول الإدخال

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الإدخال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
action_idstringمطلوب في العنصر الأب
  • format: "uuid"
idempotency_keystringمطلوب في العنصر الأب
  • format: "uuid"
replacement_action_idstringاختياري / عنصر
  • format: "uuid"
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "action_id": {
      "type": "string",
      "format": "uuid"
    },
    "idempotency_key": {
      "type": "string",
      "format": "uuid"
    },
    "replacement_action_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "workspace_id",
    "action_id",
    "idempotency_key"
  ],
  "additionalProperties": false
}

مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

مخرجات منظّمة
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
contract_versionstringمطلوب في العنصر الأب
  • const: "community-engagement/v1"
action_idstringمطلوب في العنصر الأب
  • format: "uuid"
statusstringمطلوب في العنصر الأب
  • enum: ["queued","executing","succeeded","attention","failed"]
execution_stagestringمطلوب في العنصر الأب
  • enum: ["execute","verify"]
verification_countintegerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
verification_evidenceobjectمطلوب في العنصر الأب
  • additionalProperties: {}
verification_evidence.*any JSON valueاختياري / عنصر—
delivery_outcomestringمطلوب في العنصر الأب
  • enum: ["confirmed","recovered","not_attempted","unknown"]
follow_up_requiredbooleanمطلوب في العنصر الأب—
resolutionobject | nullمطلوب في العنصر الأب—
resolutionanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
resolution.action_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
resolution.workspace_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
resolution.kindanyOf 1stringمطلوب في العنصر الأب
  • enum: ["confirmed_delivery","confirmed_replacement"]
resolution.replacement_action_idanyOf 1string | nullمطلوب في العنصر الأب—
resolution.replacement_action_idanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
resolution.replacement_action_idanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
resolution.evidenceanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: {}
resolution.evidence.*anyOf 1any JSON valueاختياري / عنصر—
resolution.created_byanyOf 1string | nullمطلوب في العنصر الأب—
resolution.created_byanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
resolution.created_byanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
resolution.created_atanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
resolutionanyOf 2nullمطلوب في العنصر الأب—
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "community-engagement/v1"
    },
    "action_id": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "queued",
        "executing",
        "succeeded",
        "attention",
        "failed"
      ]
    },
    "execution_stage": {
      "type": "string",
      "enum": [
        "execute",
        "verify"
      ]
    },
    "verification_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "verification_evidence": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "delivery_outcome": {
      "type": "string",
      "enum": [
        "confirmed",
        "recovered",
        "not_attempted",
        "unknown"
      ]
    },
    "follow_up_required": {
      "type": "boolean"
    },
    "resolution": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "action_id": {
              "type": "string",
              "format": "uuid"
            },
            "workspace_id": {
              "type": "string",
              "format": "uuid"
            },
            "kind": {
              "type": "string",
              "enum": [
                "confirmed_delivery",
                "confirmed_replacement"
              ]
            },
            "replacement_action_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "evidence": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "created_by": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "created_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            }
          },
          "required": [
            "action_id",
            "workspace_id",
            "kind",
            "replacement_action_id",
            "evidence",
            "created_by",
            "created_at"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "contract_version",
    "action_id",
    "status",
    "execution_stage",
    "verification_count",
    "verification_evidence",
    "delivery_outcome",
    "follow_up_required",
    "resolution"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

{
  "name": "sosoapi_reconcile_comment_outcome",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "action_id": "11111111-1111-4111-8111-111111111111",
    "idempotency_key": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "contract_version": "community-engagement/v1",
  "action_id": "11111111-1111-4111-8111-111111111111",
  "status": "queued",
  "execution_stage": "execute",
  "verification_count": 0,
  "verification_evidence": {},
  "delivery_outcome": "confirmed",
  "follow_up_required": false,
  "resolution": null
}
تثبيت MCP أو ربطه