MCP Tool

Desktop: Widget UPDATE

Aendert ein Widget: KPI-Titel, KPI-Einstellungen (felder ersetzt alle Einstellungen) oder Raum. Ohne felder bleiben die Einstellungen erhalten. Fuer nur_pruefen=true sind vollstaendige felder erforderlich; die KPI-Vorschau wird ohne Desktopaenderung im verifizierten aktuellen Chat gespeichert. Bei chat_artifact_status.gespeichert=true die zurueckgegebene artifact_id unveraendert in der Antwort nennen, damit die Chatkarte zugeordnet werden kann. Keine Desktop-ID oder ASCII-Diagramme erfinden.

Tool-Name

tool

update_desktop_widget

Parameter

Parameter	Typ	Pflicht	Beschreibung
`referenzfelder`	`object`	Ja	–
`inhalt`	`object`	Nein	–

Input Schema

json

{
    "type": "object",
    "properties": {
        "inhalt": {
            "type": "object",
            "properties": {
                "titel": {
                    "type": "string",
                    "description": "Optional: neuer Titel"
                },
                "felder": {
                    "type": "object",
                    "description": "Optional: KPI-Einstellungen als flache Formularfelder, z. B. {\"filter__datumsauswahl\":\"dieses_jahr\"}"
                },
                "raum": {
                    "type": "string",
                    "description": "Optional: Raum-ID; leer = global (in allen Raeumen)"
                },
                "nur_pruefen": {
                    "type": "boolean",
                    "description": "Optional: true = KPI-Vorschau ohne Desktopaenderung. Mit desktop_schluessel der aktuellen Chatnachricht wird die Vorschau dort als echtes Widget gespeichert; chat_artifact_status meldet den separaten Speicherstatus."
                },
                "revision": {
                    "type": "string",
                    "description": "Optional: revision aus select_sdkinvisible_desktop_widgets (Konfliktschutz)"
                },
                "desktop_schluessel": {
                    "type": "string",
                    "pattern": "^dk_[a-f0-9]{32}$",
                    "description": "desktop_schluessel aus der aktuellen Chatnachricht ([tricoma-Desktop] desktop_schluessel=dk_...). Im Agentic Chat immer mitgeben."
                }
            },
            "additionalProperties": false
        },
        "referenzfelder": {
            "type": "object",
            "properties": {
                "ID": {
                    "type": "string",
                    "description": "Widget-ID (kpi-... oder Katalog-ID)"
                }
            },
            "required": [
                "ID"
            ],
            "additionalProperties": false
        }
    },
    "required": [
        "referenzfelder"
    ]
}

Beispiel-Aufruf

json

{
    "tool": "update_desktop_widget",
    "arguments": {
        "referenzfelder": {},
        "inhalt": {}
    }
}