decisiongatedocs_search

Cerca la documentació de Decision Gate per a orientació en temps d’execució.

Notes clau

• Utilitzeu per a consultes ràpides sobre el flux d’evidències, comparadors i semàntica dels proveïdors.
• Retorna seccions classificades amb etiquetes de rol i suggeriments de seguiment.
• La cerca és determinista i està limitada al catàleg de documents configurat.

Inputs

• max_sections (opcional): Nombre màxim de seccions a retornar (per defecte 3, límit màxim 10).
• query (required): Consulta de cerca per a seccions de documentació.

Input Schema

{
  "$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"
}

Sortides

• docs_covered (requerit): Tipus: array.
• seccions (requerit): Tipus: array.
• suggested_followups (required): Suggeriments de seguiment conscients del rol.

Esquema de sortida

{
  "$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"
}

Exemples

Cerca evidències del flux i orientació del carril de confiança.

Input:

{
  "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."
  ]
}