feat(actor): enforce actor-first plan resolution

This commit is contained in:
2026-01-14 17:35:09 -05:00
parent 6dfd41cafe
commit edc566d5ab
14 changed files with 259 additions and 173 deletions
+3 -3
View File
@@ -55,7 +55,7 @@ LangSmith tracing is optional and off by default. Enable it by exporting `CLEVER
## LLM provider configuration
CleverAgents ships with a LangChain/LangGraph powered provider registry that discovers whichever API keys you export and automatically selects the best available provider. The CLI always prefers explicit choices (`agents tell --provider anthropic --model claude-sonnet-4-20250514`), followed by `CLEVERAGENTS_DEFAULT_PROVIDER` and `CLEVERAGENTS_DEFAULT_MODEL`, then any defaults defined inside `Settings`, and finally the built-in fallback order (`openai → anthropic → google → azure → openrouter → groq → together → cohere → gemini`).
CleverAgents ships with a LangChain/LangGraph powered provider registry that discovers whichever API keys you export and automatically selects the best available provider. The CLI now uses actors: select an actor with `--actor <name>` (or set a default via `agents actor set-default`). Actors embed provider/model choices; built-in actors are seeded from `CLEVERAGENTS_DEFAULT_PROVIDER` / `CLEVERAGENTS_DEFAULT_MODEL`, then fall back to the built-in order (`openai → anthropic → google → azure → openrouter → groq → together → cohere → gemini`).
### Required environment variables
@@ -75,7 +75,7 @@ Set `CLEVERAGENTS_DEFAULT_PROVIDER` to pin the global provider (for example `exp
### Diagnostics and testing shortcuts
- `agents diagnostics` prints whether the registry can see your credentials.
- `agents tell` and `agents build` accept `--provider/--model` flags for one-off overrides.
- `agents diagnostics` prints whether the registry can see your credentials and which actor/provider is selected.
- `agents tell` and `agents build` require `--actor <name>` unless a default actor is set; use `agents actor set-default <name>` to configure one.
- `CLEVERAGENTS_TESTING_USE_MOCK_AI=true` forces the in-repo mock provider so Behave/Robot suites never hit external APIs.
- The full capability matrix (streaming, tool calls, JSON mode, etc.) plus every supported environment variable is documented in `docs/reference/providers.md` and `docs/reference/env_variables.yaml`.