2Slides Logo
Come generare presentazioni con Hermes Agent + 2Slides (guida completa)
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:

  1. 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à.
  2. 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.
  3. Il ciclo di auto-miglioramento di Hermes raffina l'integrazione nel tempo. La prima volta che chiedi una presentazione, Hermes chiama
    generate
    con 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 setup

La 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-2slides

Poi 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 ~/.bashrc

Riavvia 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 scuro

Hermes farà quanto segue:

  1. Chiamerà
    search-themes
    con la query "modern dark" per scegliere un theme ID
  2. Chiamerà
    generate
    con i tuoi contenuti e quel tema
  3. Farà polling su
    jobs/:id
    ogni 5 secondi finché il job non sarà completato
  4. Restituirà uno
    slideUrl
    condivisibile e un
    pdfUrl

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:

IntentoPrompt per HermesEndpoint 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-deck

La 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 Slack

Hermes 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