Ecco la frase che causa i difetti più costosi nell'automazione di LinkedIn: l'API ha restituito 200, quindi il post è uscito.
Non necessariamente. Un 2xx da una qualunque API di LinkedIn significa che la richiesta è stata accettata e passata avanti. Quello che LinkedIn ne fa dopo — non mostrarla a nessuno, trattenerla per revisione, scartarla in silenzio, mostrarla e toglierla venti minuti dopo — non sta in quella risposta, e in diversi casi non sta in nessuna risposta.
Perché esiste quella distanza
Fra il vostro codice e un post visibile ci sono almeno due salti, e il secondo è una piattaforma con opinioni proprie sui contenuti automatizzati. Un codice di stato sincrono non può riferire di una decisione che non è ancora stata presa. Nessuno sta nascondendo niente; l'informazione non esiste nel momento in cui la risposta viene scritta.
Che fare invece di dare per scontato
- Salvate quello che avete mandato, con la risposta e un orario. Non un booleano: il corpo.
- Rileggetelo. Se un post conta, andate a prenderlo dopo e registrate che cosa è tornato.
- Trattate il numero di chiamate e il numero di risultati visibili come due metriche diverse, perché lo sono.
- Non mostrate mai “pubblicato” a un cliente sulla sola forza di un codice di stato.
La versione che fa più male
Un tempo scaduto. La vostra richiesta non è fallita — avete solo smesso di aspettare la risposta. È benissimo possibile che la scrittura sia arrivata. Riprovare è il modo in cui un messaggio diventa due, e il secondo è quello che il vostro cliente nota. Tenete un id per ogni scrittura che intendete fare, controllate prima di riprovare, e preferite rileggere il mondo al rigiocare la richiesta.
Domande frequenti
Un agente IA conosce la differenza?
Solo se gliela si dice. Un agente IA che riceve un 200 di solito riferirà il post come pubblicato. Mettete la regola nelle sue istruzioni: riferire una scrittura come accettata, e rileggerla prima di dire che è uscita.
Come riferisce una scrittura una stanza di progetto?
Con la risposta dell'agente IA, nella stanza, dove tutti la vedono. È un buon motivo per chiedere all'agente di citare ciò che ha inviato e l'id che ha ricevuto in cambio.