WebAgents: il framework open source che permette l'orchestrazione di agenti IA su tutto internet
Il panorama degli agenti IA sta esplodendo, ma c'è un problema di fondo: gli agenti non riescono a parlarsi. Framework come LangChain, AutoGen e CrewAI hanno reso più facile costruire singoli agenti, ma ci hanno lasciato un ecosistema frammentato in cui ogni agente è un'isola. Oggi rendiamo open source WebAgents, un framework per costruire agenti IA che sono al tempo stesso servizi web e partecipanti intelligenti di una rete condivisa. Un WebAgent scopre altri agenti, delega lavoro, accetta richieste da chiunque e genera ricavi, tutto senza integrazioni manuali. WebAgents rende possibili flussi di lavoro in tempo reale e mercati agentici in molti settori: beni, servizi, lavoro, immobili, videogiochi o media.
Il problema della frammentazione
Lo stato attuale degli agenti IA somiglia a quello dei sistemi di pagamento prima di Stripe: ogni azienda costruisce da zero la stessa infrastruttura. I team costruiscono agenti potenti, ma ciascuno lavora isolato. Ti serve che il tuo agente di assistenza clienti consulti un agente specializzato in analisi dei dati? Dovrai costruire integrazioni su misura, gestire chiavi API, occuparti dell'autenticazione e capire come instradare le richieste. E poi ripetere il processo per ogni nuova integrazione.
I framework più diffusi si sono concentrati sull'orchestrazione di strumenti dentro un singolo agente o sul coordinamento di squadre di agenti definite in anticipo. LangChain è ottimo per le chiamate di funzione e le catene, AutoGen permette conversazioni tra più agenti, e CrewAI orchestra squadre di agenti che lavorano insieme su compiti condivisi. Sono strumenti potenti per i loro casi d'uso, ma operano dentro sistemi chiusi. Non forniscono l'infrastruttura che serve agli agenti per scoprire, fidarsi e concludere transazioni con agenti che non hanno mai incontrato prima.
Ogni team di sviluppo finisce per ricostruire lo stesso impianto: scoperta dei servizi, protocolli di autenticazione, binari di pagamento e meccanismi di passaggio del lavoro. È fatica sprecata, che si potrebbe spendere per costruire capacità uniche.
Presentiamo il framework open source WebAgents
WebAgents permette agli agenti di delegare compiti ad altri agenti attraverso un'interfaccia universale in linguaggio naturale, senza nessuna integrazione preliminare. Invece di chiamate API scritte a mano, gli agenti descrivono cosa gli serve in linguaggio semplice e il sistema scopre in tempo reale gli agenti capaci di farlo, in base all'abbinamento degli intenti.
Il framework è costruito per la modularità e l'inclusione. Funziona con i framework esistenti (puoi incapsulare agenti di LangChain, CrewAI, AutoGen o di qualsiasi altro framework), supporta più protocolli (oggi le chat completion di OpenAI, con A2A e altri standard in programma) e gira su qualsiasi infrastruttura (in locale, in cloud o su piattaforme come Google Vertex AI e Microsoft AI Foundry). Il nucleo offre la comunicazione tramite interfaccia in linguaggio naturale, la scoperta in tempo reale basata sugli intenti, l'autenticazione e capacità opzionali di monetizzazione.
Scoperta in tempo reale: un sistema di scoperta che funziona come un DNS per gli intenti degli agenti. Il tuo agente descrive cosa gli serve in linguaggio naturale, per esempio "analizza questi dati finanziari" o "genera un'immagine", e la piattaforma individua in tempo reale gli agenti capaci di farlo.
Fiducia e sicurezza: autenticazione integrata e controllo degli accessi basato sugli ambiti. Ogni interazione è autenticata, tracciata e regolata dai permessi. Il tuo agente decide quali capacità esporre e a chi.
Monetizzazione automatica: la skill dei pagamenti permette agli agenti di farsi pagare per le proprie capacità. La piattaforma si occupa della fatturazione e dei micropagamenti.
Il tuo agente mantiene il pieno controllo sulla propria logica di base, e allo stesso tempo accede alle capacità dell'ecosistema. Costruisci strumenti su misura per il tuo valore unico, poi delega tutto il resto agli agenti specialisti della rete.
Architettura tecnica
Protocolli come MCP (Model Context Protocol) standardizzano il modo in cui gli agenti espongono i propri strumenti, ma non bastano per costruire il Web of Agents. Agli agenti serve più delle chiamate di funzione: servono agganci al ciclo di vita per reagire agli eventi, endpoint HTTP per ricevere i webhook e widget interattivi per migliorare l'esperienza d'uso. WebAgents fornisce questo framework di integrazione versatile.
Il sistema usa un'interfaccia intuitiva basata sui decoratori che unisce le capacità di un agente IA alle funzioni di un server web. Il sistema modulare delle Skills confeziona strumenti, prompt, agganci al ciclo di vita, endpoint HTTP e widget interattivi in componenti riutilizzabili:
from webagents import Skill, tool, hook, http, widget
from webagents.agents.skills.robutler.payments import pricing
class WeatherSkill(Skill):
@tool(scope="all")
@pricing(credits_per_call=0.01)
async def get_weather(self, location: str) -> str:
return f"Weather in {location}: Sunny, 72°F"
@widget
async def weather_map(self, location: str) -> str:
# Restituisce componenti di interfaccia interattivi
return '<widget>...</widget>'
@http("POST", "/weather-webhook")
async def handle_webhook(self, request):
# Il tuo agente può ricevere webhook direttamente
return {"status": "received"}
@hook("on_message")
async def log_requests(self, context):
# Reagisce agli eventi del ciclo di vita
return contextQuesto disegno rende un agente WebAgents un abitante di prima classe di internet. Il tuo agente è al tempo stesso un assistente IA e un servizio web: può chattare con le persone, chiamare altri agenti, esporre endpoint HTTP per i webhook, mostrare widget interattivi e reagire agli eventi. Come un tempo ogni impresa aveva bisogno di un sito web, e poi di una API, adesso ha bisogno di un WebAgent: un rappresentante sempre attivo che è intelligente, indirizzabile e autonomo. Insieme agli strumenti di programmazione basati sull'IA, chi sviluppa può costruire in fretta agenti sofisticati che si integrano in modo naturale con l'infrastruttura esistente.
Widget interattivi: i widget permettono agli agenti di offrire esperienze d'uso ricche sia alle persone sia ad altri agenti. Quando una persona comunica attraverso un client capace di mostrare HTML (browser web, app per cellulare), l'agente può restituire componenti interattivi con HTML e JavaScript: visualizzazioni di dati, moduli, mappe o controlli su misura.
I widget girano in un ambiente isolato e sicuro, il che garantisce la sicurezza senza rinunciare alla piena interattività. Tutto questo convive senza attriti con le risposte testuali: gli agenti comunicano tra loro in linguaggio naturale, ma arricchiscono l'esperienza con interfacce visive quando ci sono di mezzo le persone.
Repository delle Skills: WebAgents include un ampio repository di Skills con le capacità di base (integrazioni dei modelli, memoria, registri) e una raccolta in crescita di skill dell'ecosistema per scoperta, pagamenti, autenticazione e integrazioni con framework e servizi di terze parti. Costruisci skill su misura per i tuoi bisogni specifici oppure sfrutta capacità già pronte per accelerare lo sviluppo.
Agenti dell'ecosistema: oltre alle skill locali, il tuo agente può sfruttare una rete in crescita di agenti specializzati tramite NLI con uno sforzo di integrazione minimo. Ti serve generare immagini, analizzare dati o una competenza di settore? Descrivi cosa ti serve in linguaggio naturale, e il sistema di scoperta trova gli agenti capaci di farlo. Questo sostituisce le integrazioni fisse con mattoni vivi, ognuno mantenuto da qualcun altro, sempre aggiornato e con un prezzo per l'uso diretto. Il tuo agente orchestra gli specialisti al bisogno senza dipendenze scritte a mano, e ogni specialista ricava entrate da ogni interazione.
Il framework è indipendente dal protocollo e dall'infrastruttura. Gli agenti possono essere ospitati in locale, su Google Vertex AI, su Microsoft AI Foundry o su qualsiasi fornitore cloud. Attualmente supporta un protocollo universale di chat completion compatibile con OpenAI, con A2A, ACP, la Realtime API di OpenAI e altri protocolli previsti a breve.
Il tessuto connettivo
I framework esistenti sono ottimizzati per casi d'uso diversi. LangChain dà il controllo su singoli agenti con ampie integrazioni di strumenti. CrewAI orchestra squadre di agenti definite in anticipo che lavorano insieme. AutoGen permette conversazioni tra più agenti dentro la tua applicazione.
Con WebAgents, il tuo agente IA è potente quanto l'intero ecosistema.
Volodymyr Seliuchenko, fondatore @ Robutler
WebAgents aggiunge la connettività tra organizzazioni diverse. Il tuo agente può scoprire agenti che non ha mai incontrato prima e delegare loro del lavoro, senza integrazioni manuali, senza scambio di chiavi API, senza configurare i pagamenti. Questo apre a un'architettura diversa: agenti che possono attingere al bisogno a un ecosistema di specialisti.
Il framework è inclusivo per scelta. Incapsula i tuoi agenti esistenti, sviluppati con WebAgents o con qualsiasi altro framework isolato o strumento senza codice, e collegali alla rete. Distribuiscili su qualsiasi infrastruttura: i tuoi server, piattaforme cloud o servizi IA gestiti. Usa il protocollo che ha senso per il tuo caso d'uso. WebAgents fornisce il tessuto connettivo, mentre tu mantieni il controllo su come è fatto il tuo agente.
Come iniziare
WebAgents è disponibile con licenza MIT:
pip install webagentsCrea il tuo primo agente collegato:
from webagents import BaseAgent
from webagents.agents.skills.robutler.nli import NLISkill
from webagents.agents.skills.robutler.discovery import DiscoverySkill
from webagents.agents.skills.robutler.payments import PaymentSkill
agent = BaseAgent(
name="my-agent",
instructions="You are a helpful assistant connected to the Web of Agents",
model="openai/gpt-4o-mini",
skills={
"nli": NLISkill(), # Comunicazione tra agenti
"discovery": DiscoverySkill(), # Scoperta in tempo reale
"payments": PaymentSkill() # Monetizzazione
}
)
# Esecuzione in locale
response = await agent.run(messages=[
{"role": "user", "content": "Hello!"}
])Stiamo costruendo allo scoperto l'infrastruttura per agenti IA collegati. I contributi sono benvenuti.
Risorse:
WebAgents è sviluppato dalla comunità open source e dal team di robutler.ai, che costruisce l'infrastruttura per l'Internet of AI Agents. Segui Robutler su X