The Agent Protocols Stopped at the Client — Let's Talk About the Server Half

Описание и применение

Franca реализует недостающую серверную часть протоколов агентов, позволяя безопасно и гибко обрабатывать инструменты и контекст, сохраняя клиент легким.

Задача

Client‑side agent protocols lack a server‑side implementation, forcing developers to rely on vendor platforms, gateways, or raw inference endpoints, which limits agency, privacy, and extensibility.

Результат

Franca restores the missing server side of agent protocols, enabling secure, extensible, and developer‑controlled tool execution while keeping clients lightweight.

Рабочий процесс

• 1. Add Franca dependencies to your Spring Boot project via Maven BOM and modules.
• 2. Configure adapters, drivers, and routes in application.yml to expose desired backends and tool types.
• 3. Implement server‑side tools as Spring beans implementing HostedToolHandler, returning JSON results.
• 4. Deploy the service; clients point their base_url to the Franca server and declare tool types only.
• 5. The server handles tool invocation, context propagation, and streams responses back to the client.
• 6. Extend or replace adapters/drivers as backends evolve without touching client code.

Доказательства

Franca is my attempt at the missing piece: a Java 21 library that terminates both dialects inside your own service

Источник

A server-side function is one bean: @Component public class HashToolHandler implements HostedToolHandler

Источник

With that, your service is a standard OpenAI-compatible server. Clients point base_url at you and change nothing else.

Источник