Agenor Documentation¶
Multi-agent coordination for the JVM. Autonomous agents that negotiate, delegate, and execute — with pluggable LLM reasoning when you need it.
Agenor lets you build autonomous, message-driven agents with minimal boilerplate — starting simple and evolving incrementally toward production-grade deployments. Built on Java 21+ virtual threads, with native support for MCP, A2A, Guardrails, and Human-in-the-Loop.
New to Agenor? Start with the Getting Started Guide.
Core Guides¶
| Document | Description |
|---|---|
| Getting Started | Build and run your first agent in 5 minutes |
| Architecture Guide | Modules, abstractions, and design decisions |
| Agent Development Guide | Lifecycle, annotations, patterns |
| Configuration Guide | YAML config, environment variables |
| LLM Integration Guide | OpenAI, Anthropic, Ollama providers |
| Guardrails Guide | The Guardrails Layer |
| Memory Guide | MemoryStore, MemoryScope, InMemoryStore, BaseAgent memory API |
| Agent State Persistence Guide | Stateful, FilePersistenceService, @PersistenceConfig |
| Messaging Guide | MessageDispatcher, topics, direct messaging, subscriptions (since 0.20.0) |
| Agent Directory Guide | AgentRegistry, AgentDiscovery, AgentResolver, AgentPresence (since 0.20.0) |
| Dialogue Protocol | A2A protocol, request/reply, CFP |
| Message Filtering Guide | Filters |
| Observability Guide | OpenTelemetry tracing and span taxonomy |
Behaviors¶
| Document | Type |
|---|---|
| Behaviors Overview | When work runs, and what is deliberately not a behavior |
| OneShotBehavior | Execute once, immediately or after a delay |
| CyclicBehavior | Repeat at fixed interval |
| FSMBehavior | Finite State Machine |
| SequentialBehavior | Step-by-step execution |
| Human-In-The-Loop | Human-in-the-Loop Checkpoint |
Adapters¶
| Document | Description |
|---|---|
| MCP Adapter | Integrate Model Context Protocol servers into Agenor agents |
| Redis Messaging Adapter | At-least-once distributed messaging via Redis Streams (since 0.21.0) |
| JDBC Directory Adapter | Persistent, JDBC-backed agent directory (ADR-022, ADR-023) |
| Persistent HITL | JDBC-backed Human-in-the-Loop approval queue (ADR-022, ADR-024) |
Integrations¶
| Document | Description |
|---|---|
| Spring Boot Starter | zero-configuration auto-wiring of AgenorRuntime into any Spring Boot 4.0.x application |
Examples¶
Runnable examples with a structured learning path are in agenor-examples/README.md.