Discovery — live, senza autenticazione
Due superfici pubbliche che un agente legge prima di toccare qualsiasi cosa.
Entrambe vivono sull'host dell'app app.entradigm.com, sono
abilitate CORS e non richiedono autenticazione. Contengono solo la documentazione
della piattaforma e lo schema pubblico — mai dati dei tenant.
Orientamento (llm.txt)
Orientamento in testo semplice per agenti LLM: la documentazione della piattaforma in markdown, l'elenco degli endpoint attivi e ricette curl da copiare e incollare.
Apri llm.txt →Introspezione (intent schema)
Lo schema JSON leggibile dalle macchine di ogni intent — le strutture di richiesta, risposta, slide e provenienza — più il blocco capabilities: apiVersion e i flag live per intent che dichiarano cosa può fare questo deployment. Leggibile da qualsiasi origine.
Apri lo schema →L'handshake
Orientarsi → introspezionare → agire — in tre chiamate.
I primi due passi sono senza autenticazione; il terzo è protetto da bearer token e soggetto a rate limit — l'agente passa il token del tenant per avviare un ciclo.
# 1. orient
curl -s https://app.entradigm.com/.well-known/llm.txt
# 2. introspect the capabilities block
curl -s https://app.entradigm.com/strategist/schema | jq '.capabilities.intents'
# 3. act (bearer-gated)
curl -s -X POST https://app.entradigm.com/strategist/run \
-H "Authorization: Bearer $ENTRADIGM_TOKEN" \
-H "Content-Type: application/json" \
-d '{"intent":"generate-cycle","tenant":"your-tenant","cycleId":"2026-07-23-demo"}'In produzione, POST /strategist/run si aspetta inoltre la configurazione del tenant passata inline come tenantConfig (opzionale nello schema, richiesta dal runtime di produzione) — vedi la forma della richiesta nello schema qui sopra.
Un agente esterno — il tuo workflow n8n, il tuo scenario Make, il tuo coding
agent — guida Entradigm attraverso lo stesso contratto tipizzato con schema e lo
stesso gate di revisione umana di un operatore nell'interfaccia: i cicli avviati
da un agente si fermano per l'approvazione umana prima che qualcosa venga
pubblicato. Tre ulteriori endpoint schema pubblici
(/strategist/tools/schema,
/memory/schema, /library/schema)
sono indicizzati in llm.txt.
Cosa facciamo meglio
Una superficie che un agente può già leggere oggi — e un contratto progettato per questo.
Le capacità attive portano un tag Live. Le proprietà della futura
API pubblica versionata portano un tag Obiettivo di design —
il percorso formale /v1/ è nella roadmap qui sotto.
Discovery senza autenticazione
Il llm.txt pubblico e l'intent schema su /strategist/schema — leggibili da qualsiasi origine, senza token.
Intent attraverso un unico endpoint
Gli intent degli agenti girano protetti da bearer token e con rate limit via /strategist/run — gli stessi gate, gli stessi budget e la stessa revisione umana del trigger in-app.
Matrice delle capacità leggibile dalle macchine
Il blocco capabilities nello schema dice a un agente cosa può fare questo deployment — flag live per intent, piattaforme supportate e tipi di contenuto — prima che ci provi.
API versionata
L'API pubblica è progettata per un percorso versionato (/v1/), così il contratto non cambia sotto i piedi di un agente.
Envelope di errore unificato
L'API pubblica restituirà gli errori come {error:{code,message,context}} — leggibili dalle macchine e coerenti, invece di prosa libera.
Paginazione a cursore & header di rate-limit
L'API pubblica è progettata per scorrere le liste con cursori stabili e riportare il budget rimanente in ogni risposta tramite gli header X-RateLimit-*. Anche i payload webhook firmati per gli eventi di ciclo fanno parte del quadro obiettivo.
Roadmap
Cosa arriva dopo per la superficie agenti.
Ognuna di queste voci porta il suo tag roadmap su ogni superficie che la nomina. Il contratto live qui sopra è ciò su cui costruisci oggi.
Server MCP
Un singolo endpoint attraverso cui qualsiasi agente LLM integra Entradigm come strumento con piena introspezione dello schema.
Nodo n8n
Un nodo nativo per i workflow di automazione n8n.
SKILL.md
Un manifesto di skill leggibile dagli agenti per i coding agent.
API pubblica /v1/
L'API pubblica formale e versionata con envelope di errore, paginazione a cursore e header di rate-limit.
Pronto?