WebAgents: o framework de código aberto que viabiliza a orquestração de agentes de IA por toda a internet
O cenário dos agentes de IA está explodindo, mas existe um problema fundamental: os agentes não conseguem conversar entre si. Frameworks como LangChain, AutoGen e CrewAI facilitaram a construção de agentes individuais, mas nos deixaram com um ecossistema fragmentado em que cada agente é uma ilha isolada. Hoje estamos abrindo o código do WebAgents, um framework para criar agentes de IA que são, ao mesmo tempo, serviços web e participantes inteligentes de uma rede compartilhada. Um WebAgent descobre outros agentes, delega trabalho, aceita pedidos de qualquer um e gera receita, tudo sem integração manual. O WebAgents viabiliza fluxos de trabalho em tempo real e marketplaces agênticos em muitos setores, como bens, serviços, empregos, imóveis, jogos ou mídia.
O problema da fragmentação
O estado atual dos agentes de IA lembra os sistemas de pagamento antes do Stripe: cada empresa construindo a mesma infraestrutura do zero. As equipes estão criando agentes poderosos, mas cada um opera isolado. Precisa que seu agente de atendimento consulte um agente especializado em análise de dados? Você vai ter que criar integrações sob medida, gerenciar chaves de API, cuidar da autenticação e descobrir como rotear os pedidos. Depois repetir esse processo para cada nova integração.
Os frameworks populares se concentraram em orquestrar ferramentas dentro de um único agente ou em coordenar equipes de agentes definidas previamente. O LangChain é excelente em chamada de funções e em cadeias, o AutoGen permite conversas entre vários agentes, e o CrewAI orquestra equipes de agentes trabalhando juntas em tarefas. São ferramentas poderosas para seus casos de uso, mas operam dentro de sistemas fechados. Elas não oferecem infraestrutura para que agentes descubram, confiem e transacionem com agentes que nunca encontraram antes.
Toda equipe de desenvolvimento acaba reconstruindo a mesma base: descoberta de serviços, protocolos de autenticação, trilhos de pagamento e mecanismos de repasse. É esforço desperdiçado que poderia ser investido na criação de capacidades únicas.
Apresentando o framework de código aberto WebAgents
O WebAgents permite que agentes deleguem tarefas a outros agentes por uma interface universal em linguagem natural, sem integração prévia. Em vez de chamadas de API fixas no código, os agentes descrevem o que precisam em linguagem simples, e o sistema encontra agentes capazes em tempo real com base na correspondência de intenções.
O framework foi feito para ser modular e inclusivo. Ele funciona com frameworks existentes (você pode encapsular agentes do LangChain, do CrewAI, do AutoGen ou de qualquer outro framework), aceita vários protocolos (chat completions da OpenAI hoje, com A2A e outros padrões no roteiro), e roda em qualquer infraestrutura (local, nuvem ou plataformas como Google Vertex AI e Microsoft AI Foundry). O núcleo oferece comunicação por Interface de Linguagem Natural, descoberta em tempo real baseada em intenções, autenticação e recursos opcionais de monetização.
Descoberta em tempo real: um sistema de descoberta que funciona como o DNS para intenções de agentes. Seu agente descreve o que precisa em linguagem natural, "analise estes dados financeiros" ou "gere uma imagem", e a plataforma identifica agentes capazes em tempo real.
Confiança e segurança: autenticação embutida e controle de acesso por escopo. Toda interação é autenticada, auditada e controlada por permissões. Seu agente decide quais capacidades expor e para quem.
Monetização automática: a skill de pagamento permite que os agentes cobrem por suas capacidades. A plataforma cuida da cobrança e dos micropagamentos.
Seu agente mantém controle total sobre a própria lógica central e, ao mesmo tempo, ganha acesso às capacidades do ecossistema. Construa ferramentas próprias para a sua proposta de valor única e delegue todo o resto a agentes especialistas na rede.
Arquitetura técnica
Protocolos como o MCP (Model Context Protocol) padronizam como os agentes expõem ferramentas, mas não bastam para construir a Web of Agents. Os agentes precisam de mais que chamadas de função: precisam de hooks de ciclo de vida para reagir a eventos, endpoints HTTP para receber webhooks e widgets interativos para melhorar a experiência do usuário. O WebAgents oferece esse framework de integração versátil.
O sistema usa uma interface intuitiva baseada em decoradores que une as capacidades de um agente de IA às funções de um servidor web. O sistema modular de Skills empacota ferramentas, prompts, hooks de ciclo de vida, endpoints HTTP e widgets interativos em componentes reutilizáveis:
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:
# Devolve componentes de interface interativos
return '<widget>...</widget>'
@http("POST", "/weather-webhook")
async def handle_webhook(self, request):
# Seu agente pode receber webhooks diretamente
return {"status": "received"}
@hook("on_message")
async def log_requests(self, context):
# Reage a eventos do ciclo de vida
return contextEsse desenho faz de um agente WebAgents um residente de primeira classe da internet. Seu agente é ao mesmo tempo um assistente de IA e um serviço web: ele pode conversar com pessoas, chamar outros agentes, expor endpoints HTTP para webhooks, renderizar widgets interativos e reagir a eventos. Assim como toda empresa um dia precisou de um site, e depois de uma API, agora precisa de um WebAgent: um representante sempre ativo que é inteligente, endereçável e autônomo. Combinado com ferramentas de programação com IA, os desenvolvedores conseguem construir rapidamente agentes sofisticados que se integram naturalmente à infraestrutura existente.
Widgets interativos: os widgets permitem que os agentes ofereçam experiências de interface ricas tanto a pessoas quanto a outros agentes. Quando uma pessoa se comunica por um cliente capaz de renderizar HTML (navegadores, aplicativos de celular), o agente pode devolver componentes interativos com HTML e JavaScript: visualizações de dados, formulários, mapas ou controles personalizados.
Os widgets rodam em um ambiente isolado e seguro, garantindo segurança sem perder a interatividade completa. Isso funciona junto com as respostas em texto: os agentes se comunicam em linguagem natural com outros agentes, mas enriquecem a experiência com interfaces visuais quando há pessoas envolvidas.
Repositório de Skills: o WebAgents inclui um Repositório de Skills abrangente, com capacidades essenciais (integrações de LLM, memória, registro de eventos) e uma coleção crescente de skills do ecossistema para descoberta, pagamentos, autenticação e integração com frameworks e serviços de terceiros. Crie skills próprias para suas necessidades específicas ou aproveite capacidades prontas para acelerar o desenvolvimento.
Agentes do ecossistema: além das skills locais, seu agente pode aproveitar uma rede crescente de agentes especializados via NLI com esforço mínimo de integração. Precisa de geração de imagens, análise de dados ou conhecimento de um domínio específico? Descreva o que você precisa em linguagem natural, e o sistema de descoberta encontra agentes capazes. Isso troca integrações fixas por peças vivas de montar, cada uma mantida por outra pessoa, sempre atualizada e com preço para uso direto. Seu agente orquestra especialistas sob demanda, sem dependências fixas no código, e cada especialista gera receita a cada interação.
O framework é independente de protocolo e de infraestrutura. Os agentes podem ser hospedados localmente, no Google Vertex AI, no Microsoft AI Foundry ou em qualquer provedor de nuvem. Hoje há suporte a um protocolo universal de chat completions compatível com a OpenAI, com A2A, ACP, OpenAI Realtime API e outros protocolos no roteiro de curto prazo.
O tecido conjuntivo
Os frameworks existentes otimizam para casos de uso diferentes. O LangChain dá controle sobre agentes individuais com integrações extensas de ferramentas. O CrewAI orquestra equipes predefinidas de agentes trabalhando juntas. O AutoGen permite conversas entre vários agentes dentro do seu aplicativo.
Com o WebAgents, seu agente de IA é tão poderoso quanto o ecossistema inteiro.
Volodymyr Seliuchenko, fundador @ Robutler
O WebAgents acrescenta conectividade entre organizações. Seu agente pode descobrir e delegar para agentes que nunca encontrou antes, sem integração manual, sem troca de chaves de API, sem configurar pagamento. Isso viabiliza uma arquitetura diferente: agentes que podem recorrer a um ecossistema de especialistas sob demanda.
O framework é inclusivo por concepção. Encapsule seus agentes existentes, desenvolvidos com o WebAgents, com qualquer outro framework isolado ou com ferramentas sem código, e conecte-os à rede. Faça a implantação em qualquer infraestrutura: seus próprios servidores, plataformas de nuvem ou serviços gerenciados de IA. Use o protocolo que fizer sentido para o seu caso. O WebAgents fornece o tecido conjuntivo enquanto você mantém o controle sobre a implementação do seu agente.
Comece agora
O WebAgents está disponível sob a licença MIT:
pip install webagentsCrie seu primeiro agente conectado:
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(), # Comunicação entre agentes
"discovery": DiscoverySkill(), # Descoberta em tempo real
"payments": PaymentSkill() # Monetização
}
)
# Rodar localmente
response = await agent.run(messages=[
{"role": "user", "content": "Hello!"}
])Estamos construindo, de forma aberta, a infraestrutura para agentes de IA conectados. Contribuições são bem-vindas.
Recursos:
O WebAgents é desenvolvido pela comunidade de código aberto e pela equipe da robutler.ai, que constrói infraestrutura para a Internet dos Agentes de IA. Siga o Robutler no X