decisiongatedocs_search

ابحث في وثائق Decision Gate للحصول على إرشادات وقت التشغيل.

ملاحظات رئيسية

• استخدم للبحث السريع عن تدفق الأدلة، والمقارنات، ودلالات المزود.
• يُرجع الأقسام المرتبة مع علامات الدور والمتابعات المقترحة.
• البحث محدد ويقتصر على فهرس الوثائق المكون.

مدخلات

• max_sections (اختياري): الحد الأقصى لعدد الأقسام التي سيتم إرجاعها (الافتراضي 3، الحد الأقصى 10).
• استعلام (مطلوب): استعلام البحث عن أقسام الوثائق.

مخطط الإدخال

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "max_sections": {
      "description": "Maximum number of sections to return (default 3, hard cap 10).",
      "maximum": 10,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Search query for documentation sections.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

المخرجات

• docs_covered (مطلوب): النوع: array.
• الأقسام (مطلوب): النوع: array.
• suggested_followups (required): مطالبات متابعة مدركة للدور.

مخطط الإخراج

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "docs_covered": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "doc_id": {
            "description": "Document identifier.",
            "type": "string"
          },
          "doc_role": {
            "description": "Documentation role for search weighting and display.",
            "enum": [
              "reasoning",
              "decision",
              "ontology",
              "pattern"
            ],
            "type": "string"
          },
          "doc_title": {
            "description": "Document title.",
            "type": "string"
          }
        },
        "required": [
          "doc_id",
          "doc_title",
          "doc_role"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "sections": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "content": {
            "description": "Section content (raw Markdown).",
            "type": "string"
          },
          "doc_id": {
            "description": "Document identifier.",
            "type": "string"
          },
          "doc_role": {
            "description": "Documentation role for search weighting and display.",
            "enum": [
              "reasoning",
              "decision",
              "ontology",
              "pattern"
            ],
            "type": "string"
          },
          "doc_title": {
            "description": "Document title.",
            "type": "string"
          },
          "heading": {
            "description": "Section heading.",
            "type": "string"
          },
          "rank": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "rank",
          "doc_id",
          "doc_title",
          "doc_role",
          "heading",
          "content"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "suggested_followups": {
      "description": "Role-aware follow-up prompts.",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "sections",
    "docs_covered",
    "suggested_followups"
  ],
  "type": "object"
}

أمثلة

ابحث عن تدفق الأدلة وإرشادات مسار الثقة.

مدخل:

{
  "max_sections": 2,
  "query": "precheck vs live run trust lanes"
}

Output:

{
  "docs_covered": [
    {
      "doc_id": "evidence_flow_and_execution_model",
      "doc_role": "reasoning",
      "doc_title": "Evidence Flow + Execution Model"
    }
  ],
  "sections": [
    {
      "content": "...",
      "doc_id": "evidence_flow_and_execution_model",
      "doc_role": "reasoning",
      "doc_title": "Evidence Flow + Execution Model",
      "heading": "Core Data Flow",
      "rank": 0
    }
  ],
  "suggested_followups": [
    "Refine the query with comparator or provider keywords for targeted guidance."
  ]
}