report_friction

Diagnostiek en systeem · macOS · Windows

Effect: verzenden. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Stuurt het LMCP-team een anoniem signaal dat een LMCP-tool is mislukt, niets bruikbaars teruggaf of niet kon doen wat de gebruiker vroeg, zodat het team het kan oplossen. Bied het de gebruiker aan na zo'n mislukking en verstuur het wanneer ze akkoord gaan. Het bevat een categorie, de toolnaam en feiten die LMCP zelf verzamelt: de klasse van de fout, het type en de ruwe grootte van elk argument van de mislukte aanroep (nooit de waarde), de namen en uitkomsten van de laatste tien toolaanroepen, en of de app is geïnstalleerd, draait en toestemming heeft. Het bevat nooit het verzoek, bericht of de e-mailinhoud van de gebruiker, accountnamen of andere persoonsgegevens. Het wordt bij deze aanroep verstuurd (er is geen voorbeeld), en er wordt niets verstuurd wanneer de gebruiker anonieme signalen heeft uitgezet.

Vereiste invoer

friction_type

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — macOS

{
  "properties": {
    "attempt_count": {
      "description": "How many times this was attempted (optional).",
      "type": "integer"
    },
    "error_category": {
      "description": "Category of what went wrong (optional).",
      "enum": [
        "permission",
        "timeout",
        "empty",
        "not_found",
        "parse",
        "wrong_result",
        "missing_capability",
        "crash",
        "other"
      ],
      "type": "string"
    },
    "friction_type": {
      "description": "What kind of friction you observed.",
      "enum": [
        "repeated_failure",
        "task_abandoned",
        "workaround_needed",
        "cannot_complete",
        "other"
      ],
      "type": "string"
    },
    "intent_category": {
      "description": "What the user was trying to do, chosen from this list (optional). Pick the closest one; do not describe the request.",
      "enum": [
        "find_email",
        "read_email",
        "send_email",
        "send_message",
        "read_messages",
        "schedule_event",
        "read_calendar",
        "manage_reminder",
        "manage_note",
        "manage_contact",
        "read_file",
        "write_file",
        "search_files",
        "document_work",
        "cloud_storage",
        "browse_web",
        "run_command",
        "other"
      ],
      "type": "string"
    },
    "tool_attempted": {
      "description": "Name of the LMCP tool involved (e.g. list_emails). Optional.",
      "type": "string"
    }
  },
  "required": [
    "friction_type"
  ],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor report_friction. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "friction_type": "cannot_complete"
}

Windows