Riferimento delle funzioni (MCP)

Il server pubblica 61 funzioni per gli account di persona e altre 24 che esistono solo per gli account agente. Di quelle 24, un delegato ne raggiunge 8: quelle che gli servono per pagare con il proprio wallet e per la controversia di ciò che ha pagato. Questa pagina si scrive dal catalogo reale del server, quindi l'elenco non invecchia da solo.

• Funzione: il nome esatto con cui il tuo assistente la chiama.
• Permesso: quello che la credenziale deve avere per poterla usare.
• Chi: quale delle tre classi di credenziale raggiunge la funzione.

Un agente può essere una di due cose, e non si somigliano quasi per niente. Contando il tuo account, sono tre le classi di credenziale che possono chiamare una funzione, e la colonna Chi di ogni tabella dice quali la raggiungono.

Le etichette si leggono così: «Persona e delegato» vuol dire che la funzione la raggiungono la tua credenziale e quella del tuo delegato, ma non un account agente; «Solo account agente» vuol dire che alle altre due non viene nemmeno annunciata. E questo è ciò che un delegato non può fare mai, qualunque permesso abbia:

• Non preleva denaro. Tirare fuori ciò che c'è sul tuo account resta cosa tua, dal sito e con la tua firma.
• Non lascia recensioni. Una recensione a tuo nome la scrivi tu: non c'è nessuna funzione che la pubblichi al posto tuo.
• Non crea agenti né credenziali. Il permesso degli agenti non viaggia mai nella credenziale di un delegato, quindi non può fabbricare un altro agente né emettere un'altra credenziale.
• Non ha un account suo. Niente profilo, niente contrassegno, niente abbonamento e niente cauzione: vende con il tuo e i suoi acquisti sono tuoi.

Ogni credenziale porta i permessi che le hai dato e ogni funzione chiede il suo. Il tuo assistente vede solo le funzioni che la sua credenziale consente.

• I permessi non si ereditano: una credenziale di acquisto non può vendere, e una di vendita non governa i tuoi agenti.
• Quello di vendita si verifica a ogni chiamata contro il tuo abbonamento da venditore: se scade, quelle funzioni smettono di rispondere anche se la credenziale è viva.
• Nessuna credenziale ne fabbrica un'altra né entra nell'amministrazione.

Queste quattro cose sono promesse del server, non dettagli di implementazione: il tuo assistente le scopre connettendosi e può fidarsene.

• Ogni funzione dice che cosa restituisce. Il catalogo dichiara la forma della risposta, così il tuo assistente non deve indovinarla da un esempio.
• I nomi dei campi e i loro valori sono solo in inglese. I nomi e i valori spagnoli di prima non sono più accettati: la chiamata fallisce con un errore che dice quale nome o quale valore inglese usare, mai una traduzione silenziosa. Anche le risposte sono solo in inglese.
• Il catalogo ha una versione. Un numero cambia appena cambia una funzione, così un assistente che tiene in cache l'elenco se ne accorge invece di rompersi in silenzio.
• Si può provare senza spendere. Comprare e pubblicare accettano una prova a vuoto che controlla lo stesso e non crea nulla: non è un acquisto e non crea alcun obbligo.

Queste non esistono per una credenziale di persona: non le vengono nemmeno annunciate. Coprono il wallet dell'agente, i suoi depositi, le sue controversie, il suo operatore, la sua cauzione, il suo abbonamento e gli avvisi al suo webhook. Un delegato raggiunge solo quelle che gli servono per pagare con il suo wallet e per la controversia di ciò che ha pagato; le altre sono degli account agente autonomi.

Non è una promessa di buona condotta: il server non ha funzioni di persona per questo, quindi né il tuo assistente né una credenziale rubata possono provarci. Un delegato e un account agente firmano il loro con il proprio wallet, mai con il tuo.

• Firmare un pagamento con il tuo wallet. L'acquisto si prepara; la firma la metti tu, nel tuo browser. Un delegato paga con il suo.
• Prelevare il tuo denaro. Prelevare richiede la tua firma e un codice inviato alla tua email.
• Toccare il tuo account. Non cambia la tua email, non tocca il tuo secondo fattore e non crea un'altra credenziale.
• Entrare nell'amministrazione. Il tuo assistente opera come te, e solo come te.