How agntcy/coffeeagntcy works
CoffeeAgntcy is a developer-facing reference application for demonstrating AGNTCY multi-agent systems, with a smaller Corto setup and a richer Lungo setup. A user submits a prompt through a web UI or agent endpoint; a supervisor orchestrates specialized agents, which can collaborate over A2A and configurable transports to produce a response, sometimes streamed. Lungo also demonstrates MCP weather data, identity, observability, and workflow APIs. Edges reflect README-documented capabilities and the sampled HTTP-to-agent calls; unsampled internal wiring is intentionally not inferred.
Main entry points: workflows.py Workflow services · logistics/main.py Logistics supervisor · graph.py Logistics graph · auction/main.py Auction supervisor
Components 24
Corto setup
- Corto web UI
coffeeAGNTCY/coffee_agents/corto/exchange/frontend/src/App.tsx - Corto prompt API
coffeeAGNTCY/coffee_agents/corto/exchange/main.py - Exchange agent
coffeeAGNTCY/coffee_agents/corto/exchange/agent.py - Corto farm
coffeeAGNTCY/coffee_agents/corto/farm/agent.py
Lungo interface
- Lungo web UI
coffeeAGNTCY/coffee_agents/lungo/frontend/src/App.tsx - Workflow API
coffeeAGNTCY/coffee_agents/lungo/api/agentic_workflows/router.py - Workflow services
coffeeAGNTCY/coffee_agents/lungo/api/agentic_workflows/workflows.py
Workflow supervisors
- Auction supervisor
coffeeAGNTCY/coffee_agents/lungo/agents/supervisors/auction/main.py - Auction graph
coffeeAGNTCY/coffee_agents/lungo/agents/supervisors/auction/graph/graph.py - Logistics supervisor
coffeeAGNTCY/coffee_agents/lungo/agents/supervisors/logistics/main.py - Logistics graph
coffeeAGNTCY/coffee_agents/lungo/agents/supervisors/logistics/graph/graph.py - Recruiter supervisor
coffeeAGNTCY/coffee_agents/lungo/agents/supervisors/recruiter/main.py
Specialist agents
- Regional farms
coffeeAGNTCY/coffee_agents/lungo/agents/farms - Logistics farm
coffeeAGNTCY/coffee_agents/lungo/agents/logistics/farm/agent.py - Shipper
coffeeAGNTCY/coffee_agents/lungo/agents/logistics/shipper/agent.py - Accountant
coffeeAGNTCY/coffee_agents/lungo/agents/logistics/accountant/agent.py - Helpdesk
coffeeAGNTCY/coffee_agents/lungo/agents/logistics/helpdesk/agent_executor.py
Shared capabilities
- MCP services
coffeeAGNTCY/coffee_agents/lungo/agents/mcp_servers - Workflow instance store
coffeeAGNTCY/coffee_agents/lungo/common/workflow_instance_store/store.py - Identity service
coffeeAGNTCY/coffee_agents/lungo/services/identity_service_impl.py - A2A transports
coffeeAGNTCY/coffee_agents/lungo/common/a2a_transport_config.py
Other components
- User
- Weather provider
- Observe SDK
Connections 27
- User → Corto web UI: submits prompt
- Corto web UI → Corto prompt API: sends request
- User → Lungo web UI: submits prompt
- Lungo web UI → Workflow API: uses workflows
- Corto prompt API → Exchange agent: executes prompt
coffeeAGNTCY/coffee_agents/corto/exchange/main.py - Exchange agent → Corto farm: A2A interaction
- Workflow API → Workflow services: routes workflow
coffeeAGNTCY/coffee_agents/lungo/api/agentic_workflows/server.py - Workflow services → Auction supervisor: dispatches workflow
- Workflow services → Logistics supervisor: dispatches workflow
- Workflow services → Recruiter supervisor: dispatches workflow
- Auction supervisor → Auction graph: builds graph
coffeeAGNTCY/coffee_agents/lungo/agents/supervisors/auction/main.py - Logistics supervisor → Logistics graph: builds graph
coffeeAGNTCY/coffee_agents/lungo/agents/supervisors/logistics/main.py - Auction graph → Regional farms: coordinates agents
- Logistics graph → Logistics farm: coordinates agents
- Logistics graph → Shipper: coordinates agents
- Logistics graph → Accountant: coordinates agents
- Logistics graph → Helpdesk: coordinates agents
- Logistics farm → MCP services: uses MCP tools
- MCP services → Weather provider: fetches live data
- Workflow services → Workflow instance store: persists instances
- Logistics supervisor → Shipper: checks connectivity
coffeeAGNTCY/coffee_agents/lungo/agents/supervisors/logistics/main.py - Auction supervisor → A2A transports: configures transport
- Logistics supervisor → A2A transports: configures transport
- Auction supervisor → Observe SDK: traces workflow
- Logistics supervisor → Observe SDK: traces workflow
- Recruiter supervisor → Observe SDK: traces workflow
- Workflow API → Identity service: identity features