Agenti e strumenti di IA
Questa documentazione come fonte leggibile da una macchina, e ciò che un agente può davvero fare oggi con la piattaforma.
Ogni pagina di questo sito ha un gemello in Markdown, perché una buona parte del traffico qui non è umana.
Questa documentazione, letta da una macchina
Quattro vie d'accesso, tutte generate in fase di build, nessuna delle quali è un prodotto a parte.
/llms.txt è un indice di tutte le pagine con la relativa descrizione, abbastanza piccolo da incollare in un prompt. /llms-full.txt è l'intero sito in un unico file Markdown, ed è quello da dare a un agente.
Le altre due servono a raggiungere una singola pagina. Il sorgente di ogni pagina si trova in /llms.mdx/docs/<path>/content.md, e in cima a ogni pagina c'è un pulsante Copy Markdown che lo recupera. Richiedi qualsiasi URL della documentazione con un header Accept: text/markdown e ricevi il Markdown invece di una pagina HTML da analizzare.
La vecchia documentazione serviva il Markdown per ogni pagina e gli agenti dei partner hanno finito per dipenderne. Per questo qui funziona ancora.
Usi attuali
Le domande di configurazione trovano risposta senza che nessuno legga il sito. Indirizza Claude, Cursor o Codex a /llms-full.txt e fai la domanda che altrimenti faresti a noi. Come si configura una missione giornaliera con un tetto alla serie, cosa fa davvero «nascosta se bloccata», quali modelli richiedono prima un account collegato. Le risposte sono tutte lì.
I report arrivano senza che il tuo team li costruisca. Dai a un agente la documentazione di riferimento della Data API e una chiave, poi chiedi quello che vuoi davvero. I fan che hanno completato una missione il mese scorso ma da allora non hanno più aperto l'app, in CSV. Scrive le chiamate, scorre le pagine dei risultati e ti consegna il file. Da noi non gli serve niente.
In entrambi i casi è lavoro in sola lettura da parte tua, e nessuno dei due richiede che prima venga sviluppata una funzionalità.
Costruire l'esperienza dei fan con un agente
Se stai portando FanBase dentro il tuo prodotto invece di usare l'app ospitata, il percorso con un agente è il modo previsto per installare l'SDK. I pacchetti contengono i file che un agente legge, un prompt di avvio e una skill per agenti leggera, così il materiale di riferimento arriva nel repository insieme al codice.
Incolla due prompt, e l'ordine conta: prima l'accesso, poi le missioni. Unirli produce qualcosa che sembra finito e ha un accesso fittizio. Integrare con un agente contiene entrambi i prompt e l'elenco di ciò che vale la pena controllare a mano dopo.
Un assistente nel pannello di amministrazione
In valutazioneL'idea è che tu chieda quello che ti serve invece di compilare il modulo. Crea una missione giornaliera da cinquanta XP con un tetto alla serie, e lui la preparerebbe in bozza per la tua approvazione. Mostrami le missioni completate per tag nell'ultimo mese, e lui tirerebbe fuori il report.
È in discussione, non in programma. Se può cambiare il modo di lavorare del tuo team, dillo al tuo referente FanBase: sapere che un partner lo vuole è ciò che gli fa avere una data.
Gli agenti si collegano leggendo file, non tramite MCP
Per questa piattaforma, oggi, non c'è MCP. Un agente che sostiene il contrario sta tirando a indovinare, e non c'è niente da installare o da collegare.
Lo schema supportato è dare all'agente dei file da leggere e una chiave API quando gli serve. Funziona con qualsiasi strumento in grado di leggere un file.