{
    "id": "consult_resource",
    "name": "Chiedi all’agente del sito",
    "description": "Ask the BlackOrder site agent about its services, apps or articles. It uses DeepSeek to inspect the official catalog and returns recommendations, official images, requirements and source URLs. Read-only; AI commentary is explicitly inferred. Never send secrets, personal details or payment data.",
    "version": "2.1.0",
    "effect": "read",
    "generated": true,
    "endpoint": "https://blackorder.io/api/agent/tools/consult_resource",
    "method": "POST",
    "mcp": {
        "url": "https://blackorder.io/mcp",
        "tool": "consult_resource"
    },
    "inputSchema": {
        "type": "object",
        "properties": {
            "query": {
                "type": "string",
                "minLength": 3,
                "maxLength": 1600
            },
            "language": {
                "type": "string",
                "enum": [
                    "it",
                    "en"
                ],
                "default": "it"
            }
        },
        "required": [
            "query"
        ],
        "additionalProperties": false
    },
    "outputSchema": {
        "type": "object",
        "required": [
            "contract",
            "status",
            "answer",
            "results",
            "generated_at"
        ],
        "properties": {
            "contract": {
                "const": "resource-advisor/0.1"
            },
            "status": {
                "const": "ok"
            },
            "answer": {
                "type": "object"
            },
            "results": {
                "type": "array"
            },
            "generated_at": {
                "type": "string"
            }
        },
        "additionalProperties": true
    },
    "examples": [
        {
            "input": {
                "query": "Realizzate software su richiesta?",
                "language": "it"
            },
            "expected": "Generated answer citing current official Studio/service pages. No synthetic AI response is provided."
        }
    ],
    "fallback": {
        "url": "https://blackorder.io/agents/catalog",
        "text": "https://blackorder.io/llms-full.txt",
        "limitations": "Publisher facts only; HTML/text does not execute AI."
    }
}