report_friction

Diagnostica e sistema · macOS · Windows

Effetto: invio. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Invia al team di LMCP un segnale anonimo che uno strumento LMCP ha fallito, non ha restituito nulla di utile o non ha potuto fare ciò che l'utente aveva chiesto, così che il team possa correggerlo. Proponilo all'utente dopo un errore simile e inviarlo quando è d'accordo. Contiene una categoria, il nome dello strumento e fatti che LMCP raccoglie da sé: la classe dell'errore, il tipo e la dimensione approssimativa di ogni argomento della chiamata fallita (mai il suo valore), i nomi e gli esiti delle ultime dieci chiamate a strumenti e se l'app è installata, in esecuzione e autorizzata. Non contiene mai la richiesta dell'utente, il contenuto di messaggi o email, nomi di account o altri dati personali. Viene inviato con questa chiamata (non c'è anteprima) e non viene inviato nulla quando l'utente ha disattivato i segnali anonimi.

Input obbligatori

friction_type

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per report_friction. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "friction_type": "cannot_complete"
}

Windows