mirror of
https://github.com/katanemo/plano.git
synced 2026-04-25 00:36:34 +02:00
743d074184
Some checks are pending
CI / pre-commit (push) Waiting to run
CI / plano-tools-tests (push) Waiting to run
CI / native-smoke-test (push) Waiting to run
CI / docker-build (push) Waiting to run
CI / validate-config (push) Waiting to run
CI / security-scan (push) Blocked by required conditions
CI / test-prompt-gateway (push) Blocked by required conditions
CI / test-model-alias-routing (push) Blocked by required conditions
CI / test-responses-api-with-state (push) Blocked by required conditions
CI / e2e-plano-tests (3.10) (push) Blocked by required conditions
CI / e2e-plano-tests (3.11) (push) Blocked by required conditions
CI / e2e-plano-tests (3.12) (push) Blocked by required conditions
CI / e2e-plano-tests (3.13) (push) Blocked by required conditions
CI / e2e-plano-tests (3.14) (push) Blocked by required conditions
CI / e2e-demo-preference (push) Blocked by required conditions
CI / e2e-demo-currency (push) Blocked by required conditions
Publish docker image (latest) / build-arm64 (push) Waiting to run
Publish docker image (latest) / build-amd64 (push) Waiting to run
Publish docker image (latest) / create-manifest (push) Blocked by required conditions
Build and Deploy Documentation / build (push) Waiting to run
* feat: add initial documentation for Plano Agent Skills * feat: readme with examples * feat: add detailed skills documentation and examples for Plano --------- Co-authored-by: Adil Hafeez <adil.hafeez@gmail.com>
88 lines
2.9 KiB
Markdown
88 lines
2.9 KiB
Markdown
---
|
|
title: Register All Sub-Agents in Both `agents` and `listeners.agents`
|
|
impact: CRITICAL
|
|
impactDescription: An agent registered only in `agents` but not referenced in a listener's agent list is unreachable; an agent listed in a listener but missing from `agents` causes a startup error
|
|
tags: agent, orchestration, config, multi-agent
|
|
---
|
|
|
|
## Register All Sub-Agents in Both `agents` and `listeners.agents`
|
|
|
|
Plano's agent system has two separate concepts: the global `agents` array (defines the agent's ID and backend URL) and the `listeners[].agents` array (controls which agents are available to an orchestrator and provides their routing descriptions). Both must reference the same agent ID.
|
|
|
|
**Incorrect (agent defined globally but not referenced in listener):**
|
|
|
|
```yaml
|
|
version: v0.3.0
|
|
|
|
agents:
|
|
- id: weather_agent
|
|
url: http://host.docker.internal:8001
|
|
- id: news_agent # Defined but never referenced in any listener
|
|
url: http://host.docker.internal:8002
|
|
|
|
listeners:
|
|
- type: agent
|
|
name: orchestrator
|
|
port: 8000
|
|
router: plano_orchestrator_v1
|
|
agents:
|
|
- id: weather_agent
|
|
description: Provides weather forecasts and current conditions.
|
|
# news_agent is missing here — the orchestrator cannot route to it
|
|
```
|
|
|
|
**Incorrect (listener references an agent ID not in the global agents list):**
|
|
|
|
```yaml
|
|
agents:
|
|
- id: weather_agent
|
|
url: http://host.docker.internal:8001
|
|
|
|
listeners:
|
|
- type: agent
|
|
name: orchestrator
|
|
port: 8000
|
|
router: plano_orchestrator_v1
|
|
agents:
|
|
- id: weather_agent
|
|
description: Provides weather forecasts.
|
|
- id: flights_agent # ID not in global agents[] — startup error
|
|
description: Provides flight status information.
|
|
```
|
|
|
|
**Correct (every agent ID appears in both places):**
|
|
|
|
```yaml
|
|
version: v0.3.0
|
|
|
|
agents:
|
|
- id: weather_agent
|
|
url: http://host.docker.internal:8001
|
|
- id: flights_agent
|
|
url: http://host.docker.internal:8002
|
|
- id: hotels_agent
|
|
url: http://host.docker.internal:8003
|
|
|
|
model_providers:
|
|
- model: openai/gpt-4o
|
|
access_key: $OPENAI_API_KEY
|
|
default: true
|
|
|
|
listeners:
|
|
- type: agent
|
|
name: travel_orchestrator
|
|
port: 8000
|
|
router: plano_orchestrator_v1
|
|
agents:
|
|
- id: weather_agent
|
|
description: Real-time weather, forecasts, and climate data for any city.
|
|
- id: flights_agent
|
|
description: Live flight status, schedules, gates, and delays.
|
|
- id: hotels_agent
|
|
description: Hotel search, availability, pricing, and booking.
|
|
default: true # Fallback if no other agent matches
|
|
```
|
|
|
|
Set `default: true` on one agent in each listener's agents list to handle unmatched requests. The agent's URL in the global `agents` array is the HTTP endpoint Plano forwards matching requests to — it must be reachable from within the Docker container (use `host.docker.internal` for services on the host).
|
|
|
|
Reference: https://github.com/katanemo/archgw
|