2Slides Team
13 min read
Come generare presentazioni con Hermes Agent + 2Slides (guida completa)
Hermes Agent — l'agente autonomo auto-migliorante di Nous Research — si integra nativamente con 2Slides tramite lo standard aperto di skill agentskills.io. Installa il pacchetto slides-generation-2slides-skills in ~/.hermes/skills/, aggiungi la tua API key di 2Slides all'ambiente e Hermes potrà generare una presentazione 16:9 completa partendo da una sola frase in 30-60 secondi. La stessa installazione espone anche sette endpoint dell'API 2Slides — testo-a-slide, PDF-a-slide, clonazione dello stile da immagine di riferimento, narrazione multi-speaker, ricerca di temi, polling dei job ed export degli asset — come strumenti di prima classe per Hermes. Poiché Hermes dispone di un ciclo di apprendimento chiuso che scrive nuove skill a partire dall'esperienza, affina attivamente il modo in cui usa 2Slides nel tempo: scegliendo temi migliori per il tuo pubblico, preferendo l'output 4K per le presentazioni per investitori, passando a Create-Like-This quando incolli uno screenshot e pianificando report ricorrenti senza bisogno di chiederglielo due volte. Questa guida copre l'installazione, i cinque pattern di invocazione più comuni, l'uso diretto dell'API per gli utenti avanzati e gli imprevisti che mettono in difficoltà la maggior parte delle integrazioni al primo tentativo.
Cos'è Hermes Agent?
Hermes Agent è un agente IA autonomo, residente su server, realizzato da Nous Research. A differenza dei copilot integrati negli IDE o dei wrapper di chatbot, Hermes gira come processo a lunga vita sul tuo server (o su un VPS da 5 dollari), accumula memoria tra le sessioni e — cosa unica — scrive le proprie skill a partire dall'esperienza. È agnostico rispetto al modello (funziona con Nous Portal, OpenRouter, OpenAI, Anthropic, NVIDIA NIM o endpoint personalizzati), include oltre 40 strumenti integrati, supporta l'integrazione di server MCP ed espone un gateway unico che ti permette di comunicare con lui tramite Telegram, Discord, Slack, WhatsApp, Signal, email o CLI. Fonte: github.com/NousResearch/hermes-agent.
La caratteristica che rende Hermes particolarmente interessante per i workflow di presentazioni è il suo ciclo di apprendimento chiuso: dopo ogni task complesso, Hermes può creare una skill riutilizzabile e poi migliorarla durante gli utilizzi successivi. È esattamente il ciclo che fa migliorare nel tempo la generazione di slide.
Perché abbinare Hermes a 2Slides?
La combinazione è particolarmente sinergica per tre motivi:
- Hermes non ha uno strumento nativo per le slide. I suoi oltre 40 strumenti integrati coprono ricerca web, automazione del browser, visione, generazione di immagini, TTS — ma non la creazione di presentazioni. 2Slides colma esattamente questo gap di capacità.
- 2Slides espone la sua API completa come strumenti, non un solo endpoint. Il pacchetto skill 2Slides incapsula sette modalità di generazione distinte (testo, import PDF, clonazione di immagine di riferimento, narrazione, export, ricerca temi, polling di stato), così Hermes può scegliere la modalità giusta in base all'intento invece di forzare ogni richiesta attraverso un unico endpoint di generazione.
- Il ciclo di auto-miglioramento di Hermes raffina l'integrazione nel tempo. La prima volta che chiedi una presentazione, Hermes chiama
generatecon i valori di default. Alla quinta volta ha imparato che le tue presentazioni per il board del Q1 richiedono il 4K, le riunioni aziendali il 16:9 e gli aggiornamenti clienti la narrazione multi-speaker — e scrive queste preferenze in una skill di follow-up generata automaticamente.
È un pattern genuinamente diverso dall'integrazione Claude MCP, dove l'LLM chiama gli strumenti in modo stateless. Hermes ricorda.
Prerequisiti
Prima di iniziare ti servono:
- Una macchina Linux/macOS o un VPS con Python 3.10+ e Bash
- Un account 2Slides e una API key — registrati su 2slides.com/api (i nuovi account ricevono 500 crediti gratuiti, sufficienti per circa 50 pagine testo-a-slide o 5 pagine Nano Banana 2K)
- Una chiave di un provider LLM (Nous Portal, OpenRouter, OpenAI o Anthropic) che Hermes userà per il suo loop di ragionamento
- Circa 15 minuti per la configurazione iniziale
Passo 1 — Installare Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setupLa procedura guidata hermes setup richiede il tuo provider LLM, il modello di default e le credenziali opzionali del gateway di messaggistica (salta la configurazione del gateway al primo giro — potrai abilitare Telegram/Slack in seguito). Al termine dell'installazione, conferma l'installazione con hermes — dovresti entrare in un prompt CLI interattivo.
Passo 2 — Installare la skill 2Slides
La skill 2Slides si trova su github.com/2slides/slides-generation-2slides-skills e segue lo standard aperto agentskills.io che Hermes supporta nativamente. Copiala nella directory delle skill utente:
mkdir -p ~/.hermes/skills
cd ~/.hermes/skills
git clone https://github.com/2slides/slides-generation-2slides-skills.git slides-2slidesPoi aggiungi la tua API key 2Slides all'ambiente della shell così che gli script della skill possano autenticarsi:
echo 'export SLIDES_2SLIDES_API_KEY="sk-2s-..."' >> ~/.bashrc
source ~/.bashrcRiavvia la CLI di Hermes e digita /skills — dovresti vedere slides-2slides nell'elenco con le sue sette funzioni disponibili (generate, create-pdf-slides, create-like-this, generate-narration, download-slides-pages-voices, search-themes, get-job-status).
Passo 3 — Generare la tua prima presentazione
L'invocazione più semplice è una richiesta in linguaggio naturale all'interno di Hermes:
> Crea una presentazione di 10 slide sullo stato degli agenti IA nel 2026, concentrandoti su agenti autonomi vs chatbot, e usa un tema moderno scuroHermes farà quanto segue:
- Chiamerà
search-themescon la query "modern dark" per scegliere un theme ID - Chiamerà
generatecon i tuoi contenuti e quel tema - Farà polling su
jobs/:idogni 5 secondi finché il job non sarà completato - Restituirà uno
slideUrlcondivisibile e unpdfUrl
Tempo totale per una presentazione di 10 pagine: 30-60 secondi in modalità sync. La risposta include lo slideUrl, il numero di pagine e la modalità di generazione.
I cinque pattern di invocazione più utili
Non tutte le richieste dovrebbero passare da generate. La skill 2Slides espone modalità distinte così Hermes (e tu) potete scegliere quella giusta. Ecco le cinque che userai più spesso, con prompt di esempio:
| Intento | Prompt per Hermes | Endpoint sottostante |
|---|---|---|
| Creare una presentazione da zero | "Fai delle slide su X" | POST /api/v1/slides/generate |
| Convertire un PDF / whitepaper | "Trasforma questo paper di ricerca in una presentazione: /path/to/paper.pdf" | POST /api/v1/slides/create-pdf-slides |
| Riprodurre uno stile visivo | "Crea slide su X nello stile di questo screenshot: https://…" | POST /api/v1/slides/create-like-this |
| Aggiungere narrazione IA | "Aggiungi una narrazione professionale con la voce Aoede alla mia ultima presentazione" | POST /api/v1/slides/generate-narration |
| Esportare in ZIP | "Scarica tutte le slide e le voci di quel job in uno ZIP" | POST /api/v1/slides/download-slides-pages-voices |
Tutti gli endpoint condividono lo stesso involucro asincrono — invia → ottieni jobId → fai polling di GET /api/v1/jobs/:id → ricevi gli URL dei file. Questa forma coerente è il motivo per cui Hermes li gestisce in modo pulito come un set di skill invece che come sette strumenti incompatibili.
Uso diretto dell'API (per strumenti personalizzati)
Se vuoi creare uno strumento Hermes personalizzato invece di usare la skill pacchettizzata — ad esempio, uno strumento specifico di dominio "Genera presentazione OKR trimestrale con il nostro tema brand" — puoi chiamare direttamente l'API 2Slides da uno script Python che Hermes esegue.
Un pattern minimale di generate-and-wait:
import os, time, requests
API = "https://2slides.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['SLIDES_2SLIDES_API_KEY']}"}
resp = requests.post(f"{API}/slides/generate", headers=H, json={
"content": "Q1 2026 board update: ARR, retention, roadmap",
"themeId": "theme_modern_dark",
"mode": "async",
"aspectRatio": "16:9",
"resolution": "2K",
}).json()
job_id = resp["jobId"]
while True:
job = requests.get(f"{API}/jobs/{job_id}", headers=H).json()
if job["status"] in ("completed", "failed"):
break
time.sleep(5)
print(job["slideUrl"], job["pdfUrl"])Consulta Costruire un agente IA per presentazioni: guida per sviluppatori per l'architettura completa dei job asincroni e i pattern di retry. Per i pattern di system prompt che Hermes usa per decidere tra le modalità, consulta System Prompt per agenti IA di presentazioni.
Il ciclo di auto-miglioramento in azione
Ecco il pattern che distingue Hermes dagli altri runtime di agenti. La prima volta che chiedi una presentazione rivolta al cliente, Hermes produce qualcosa di generico. Ma Hermes può — e lo farà — creare una skill di follow-up al termine del task:
/skills new customer-update-deckLa skill generata automaticamente cattura ciò che ha funzionato: il theme ID che hai approvato, il rapporto d'aspetto, il nome della voce per la narrazione, il fraseggio specifico che hai chiesto per la slide di apertura. La prossima volta che dirai "customer update deck", Hermes invocherà questa skill invece della funzione grezza slides-2slides.generate. Nell'arco di dieci iterazioni la skill accumula preferenze che uno strumento stateless non ricorderebbe mai.
Ecco perché abbinare un agente auto-migliorante a un'API multi-endpoint — invece di un generatore one-shot — fa la differenza. Il ciclo di apprendimento ha qualcosa contro cui apprendere.
Pianificare job ricorrenti per le slide
Hermes include uno scheduler cron integrato. Puoi impostare un job ricorrente in una sola riga:
> Ogni lunedì alle 9, genera una presentazione di stato settimanale dal nostro documento interno di stato, aggiungi narrazione con la voce Puck e posta il PDF su #exec-updates su SlackHermes salva questo come task pianificato (hermes cron list per ispezionarlo) e lo esegue in modo autonomo. Poiché il gateway di messaggistica supporta nativamente Slack, Discord, Telegram e WhatsApp, la presentazione finita può arrivare su qualsiasi canale senza ulteriore lavoro di integrazione — il link della presentazione o il PDF arriva come messaggio di un bot sulla piattaforma che hai specificato.
Problemi comuni e soluzioni
La skill non appare in /skills. Verifica che il clone sia sotto ~/.hermes/skills/slides-2slides/ e che SKILL.md sia al livello superiore di quella directory. Esegui hermes tools per aggiornare.
"401 Unauthorized" da 2Slides. La variabile d'ambiente SLIDES_2SLIDES_API_KEY non è visibile al sottoprocesso Python della skill. Su launchd di macOS, aggiungi la chiave a ~/.config/hermes/env (che Hermes carica incondizionatamente) invece che a .bashrc.
Generazione della presentazione bloccata in pending per oltre 120 secondi. Probabilmente hai inviato in modalità sync durante le ore di punta. Reinvia con --mode async e fai polling di jobs/:id — le richieste async sono accodate in modo indipendente e in genere si completano in meno di 90 secondi anche sotto carico.
La narrazione fallisce dopo che la generazione è riuscita. La narrazione richiede il jobId di un job di generazione completato, non lo slideUrl. Controlla che la skill Hermes stia passando il jobId (UUID) e non l'URL della presentazione.
Hermes sceglie il tema sbagliato. All'inizio del ciclo di apprendimento è normale. Dopo che correggi il tema una o due volte, Hermes scrive una preferenza nella sua memoria e fa la cosa giusta nelle chiamate successive. Puoi accelerare il processo dicendoglielo direttamente: "ricorda che tutte le mie presentazioni per i clienti devono usare il tema Executive Minimal".
Domande frequenti
Hermes Agent funziona con 2Slides nel piano gratuito?
Sì. I nuovi account 2Slides ricevono 500 crediti gratuiti, che coprono circa 50 pagine di generazione standard testo-a-slide (10 crediti/pagina), circa 5 pagine Nano Banana 2K (100 crediti/pagina) o circa 2 pagine di output completamente narrato (210 crediti/pagina). Hermes stesso è rilasciato sotto licenza MIT ed è gratuito; paghi solo il provider LLM a cui lo instradi.
La skill 2Slides è un server MCP o una skill agentskills.io?
È una skill agentskills.io — lo standard aperto che Hermes, OpenClaw e diversi altri agenti supportano nativamente. 2Slides fornisce anche un server MCP separato (consulta Come MCP sta cambiando i workflow delle presentazioni), ma per Hermes in particolare il pacchetto skill è la strada più veloce perché si installa direttamente in ~/.hermes/skills/ senza alcun processo server MCP da gestire.
In cosa è diverso dall'uso di Claude + 2Slides MCP?
Claude via MCP chiama gli strumenti in modo stateless — ogni conversazione parte da zero. Hermes mantiene una memoria persistente e scrive nuove skill a partire dall'esperienza, quindi l'integrazione migliora nel tempo invece di ripetere gli stessi valori di default a ogni chiamata. Per generazioni occasionali, i due approcci sono equivalenti. Per workflow ricorrenti (report settimanali, presentazioni mensili per il board, aggiornamenti clienti ricorrenti), il ciclo di apprendimento di Hermes supera in modo significativo l'alternativa perché cattura le preferenze che a un agente stateless bisogna ripetere ogni volta.
Hermes può consegnare automaticamente le presentazioni a Slack o Telegram?
Sì. L'architettura a gateway unico di Hermes fa sì che lo stesso processo che ha generato la presentazione possa rimandarla come messaggio su qualsiasi piattaforma connessa. Dopo aver configurato il gateway Telegram o Slack tramite hermes setup, un prompt come "genera questa presentazione e posta il PDF su #board-updates su Slack" funziona end-to-end senza alcuna integrazione aggiuntiva — Hermes chiama 2Slides, fa polling del job, scarica il PDF e lo posta sul canale.
Quali lingue e risoluzioni di output sono supportate?
La skill 2Slides supporta 19 lingue (Auto, inglese, spagnolo, francese, tedesco, italiano, portoghese, russo, giapponese, coreano, cinese semplificato/tradizionale, arabo, hindi, indonesiano, vietnamita, turco, polacco, thailandese, greco), risoluzioni 1K / 2K / 4K e rapporti d'aspetto da 1:1 a 21:9 incluso il verticale (9:16) per audience mobile-first. Il costo in crediti scala con la risoluzione: 10 crediti/pagina per Fast PPT, 100 per Nano Banana 2K, 200 per Nano Banana 4K.
Il ciclo di auto-miglioramento di Hermes può andare in overfitting?
In pratica no — le skill sono a livello utente e revisionabili dall'umano. Puoi ispezionare le skill generate automaticamente con /skills e modificarle o eliminarle con /skills edit <name> o /skills remove <name>. Se Hermes preferisce troppo un tema o una voce che non ti piacciono più, correggilo una volta in conversazione e la skill si aggiornerà. Per un approfondimento su come agenti come Hermes si inseriscono nel panorama più ampio dell'automazione IA, consulta Il futuro degli agenti IA nella creazione di presentazioni e 2Slides Agent Skills: automatizza i workflow di slide IA.
In sintesi
Hermes Agent più 2Slides non è solo un'altra "integrazione IA" — è la prima combinazione in cui un agente autonomo auto-migliorante è abbinato a un'API per presentazioni multi-endpoint con abbastanza superficie per poter apprendere. Ogni altro abbinamento è o una chiamata di strumento stateless (Claude MCP, plugin di ChatGPT) o un generatore single-endpoint senza ampiezza di capacità da affinare. La memoria di Hermes più i sette endpoint distinti di 2Slides sono la forma che ricompensa davvero il ciclo di apprendimento.
Il percorso pratico nel 2026 è: installa entrambi in 15 minuti, genera tre o quattro presentazioni manualmente in modo che Hermes osservi le tue preferenze, poi lascia che sia lo scheduler a prendere il controllo. Entro un mese Hermes produce il tuo report settimanale, la presentazione trimestrale per il board e la presentazione di aggiornamento per i clienti con il pilota automatico — con il tuo tema, la tua voce, il tuo rapporto d'aspetto e il tuo canale di consegna — perché ha scritto lui stesso la skill per ciascuno.
Pronto a delegare il tuo workflow di presentazioni? Ottieni una API key 2Slides (500 crediti gratuiti) e installa Hermes Agent oggi — configurazione completa in meno di 15 minuti.
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
