From df5b23a5ee9da48daaa0a719e5823236ff4ceb5a Mon Sep 17 00:00:00 2001 From: CleverThis Date: Thu, 9 Apr 2026 05:50:09 +0000 Subject: [PATCH] docs(spec): align provider listings with implemented registry --- docs/specification.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/specification.md b/docs/specification.md index dbe7bd381..acb8026c7 100644 --- a/docs/specification.md +++ b/docs/specification.md @@ -20441,7 +20441,7 @@ The complete set of fields available in an actor definition. For the formal JSON | Field | Type | Required | Description | |-------|------|----------|-------------| -| `config.provider` | string | Yes (LLM) | LLM provider identifier: `openai`, `anthropic`, `google`, `azure`, `openrouter`, etc. | +| `config.provider` | string | Yes (LLM) | LLM provider identifier: `openai`, `anthropic`, `google`, `gemini`, `azure`, `openrouter`, `groq`, `cohere`, `together`, etc. | | `config.model` | string | Yes (LLM) | Model identifier within the provider. | | `config.actor` | string | No | Combined `provider/model` format (alternative to separate `provider` + `model`). | | `config.system_prompt` | string | No | System prompt text with Jinja2 template support. | @@ -30816,6 +30816,11 @@ Provider credential keys follow the pattern `provider..`. Each prov | `provider.google.gemini-api-key` | string | *(not set)* | `GEMINI_API_KEY` | API key for Google Gemini models. Required when using Gemini-based actors. The standard `GEMINI_API_KEY` environment variable is checked for compatibility with Google's tooling. | | `provider.huggingface.token` | string | *(not set)* | `HF_TOKEN` | Access token for Hugging Face Inference API. Required when using Hugging Face-hosted models. The standard `HF_TOKEN` environment variable is checked for compatibility with Hugging Face tooling. | | `provider.openrouter.api-key` | string | *(not set)* | `OPENROUTER_API_KEY` | API key for OpenRouter. Required when using OpenRouter as a provider. | +| `provider.groq.api-key` | string | *(not set)* | `GROQ_API_KEY` | API key for Groq Cloud inference. Required when using Groq-hosted models (e.g., `llama-3.1-70b-versatile`). Groq provides high-throughput, low-latency inference for open-source models. | +| `provider.cohere.api-key` | string | *(not set)* | `COHERE_API_KEY` | API key for Cohere models. Required when using Cohere-based actors (e.g., `command-r-plus`). | +| `provider.together.api-key` | string | *(not set)* | `TOGETHER_API_KEY` | API key for Together AI. Required when using Together-hosted open-source models (e.g., `meta-llama/Llama-3.1-70B-Instruct-Turbo`). | + +> **Note:** Support for additional providers such as Mistral AI and Ollama is tracked in [issue #5257](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/5257). Those providers will be documented here once their implementations land. #### Configuration Scoping @@ -31183,7 +31188,7 @@ The following is the formal [JSON Schema](https://json-schema.org/) definition f "properties": { "provider": { "type": "string", - "description": "LLM provider identifier: openai, anthropic, google, azure, openrouter, etc." + "description": "LLM provider identifier: openai, anthropic, google, gemini, azure, openrouter, groq, cohere, together, etc." }, "model": { "type": "string", @@ -31512,7 +31517,7 @@ The following annotated YAML provides an easier-to-read overview of the same sch type: llm | tool # Actor type (required) config: # ── For type: llm ────────────────────────────────────────── - provider: <string> # Provider identifier: openai, anthropic, google, azure, openrouter, etc. (required for LLM) + provider: <string> # Provider identifier: openai, anthropic, google, gemini, azure, openrouter, groq, cohere, together, etc. (required for LLM) model: <string> # Model identifier: gpt-4, claude-3.5-sonnet, etc. (required for LLM) # OR use the combined format: actor: "<provider>/<model>" # Combined provider/model (alternative to provider + model) @@ -31685,8 +31690,8 @@ The following annotated YAML provides an easier-to-read overview of the same sch | Field | Type | Required | Description | |-------|------|----------|-------------| | `type` | string | Yes | Actor type. `llm` for language model actors, `tool` for tool-based actors. | -| `config.provider` | string | Yes (LLM) | LLM provider identifier: `openai`, `anthropic`, `google`, `azure`, `openrouter`, etc. | -| `config.model` | string | Yes (LLM) | Model identifier within the provider: `gpt-4`, `claude-3.5-sonnet`, `gemini-pro`, etc. | +| `config.provider` | string | Yes (LLM) | LLM provider identifier: `openai`, `anthropic`, `google`, `gemini`, `azure`, `openrouter`, `groq`, `cohere`, `together`, etc. | +| `config.model` | string | Yes (LLM) | Model identifier within the provider: `gpt-4`, `claude-3.5-sonnet`, `gemini-pro`, `command-r-plus`, `llama-3.1-70b-versatile`, etc. | | `config.actor` | string | No | Combined `provider/model` format. Alternative to specifying `provider` and `model` separately. | | `config.system_prompt` | string | No | System prompt text. Supports Jinja2 template syntax for dynamic content. | | `config.temperature` | float | Provider default | Sampling temperature (0.0 to 2.0). Lower values are more deterministic. | -- 2.52.0