docs(proxy): document prompt prefix affinity router settings

This commit is contained in:
DragonAssassin-one 2026-05-11 11:10:27 +08:00
parent 55b7dbe84d
commit 62cb82d407

View file

@ -393,6 +393,8 @@ router_settings:
| optional_pre_call_checks | List[str] | List of pre-call checks to add to the router. Supported: `router_budget_limiting`, `prompt_caching`, `responses_api_deployment_check`, `encrypted_content_affinity` (requires LiteLLM >= 1.82.3), `deployment_affinity`, `session_affinity`, `forward_client_headers_by_model_group` |
| deployment_affinity_ttl_seconds | int | TTL (seconds) for user-key → deployment affinity mapping when `deployment_affinity` is enabled (configured at Router init / proxy startup). Defaults to `3600` (1 hour). |
| model_group_affinity_config | Dict[str, List[str]] | Per-model-group affinity flags. Keys are model group names; values are lists of checks to enable (`deployment_affinity`, `responses_api_deployment_check`, `session_affinity`). Groups not listed fall back to the global `optional_pre_call_checks`. [Docs](../response_api.md#per-model-group-affinity-configuration) |
| prompt_prefix_affinity_tokens | int | Number of tokens from the canonical prompt prefix used for deterministic prompt-prefix routing. Measured against tokenization of the canonical JSON representation (not the provider-specific "raw prompt token count"). |
| prompt_prefix_affinity_min_tokens | int | Minimum canonical prompt token count before prompt-prefix affinity applies. Measured against tokenization of the canonical JSON representation (not the provider-specific "raw prompt token count"). |
| ignore_invalid_deployments | boolean | If true, ignores invalid deployments. Default for proxy is True - to prevent invalid models from blocking other models from being loaded. |
| search_tools | List[SearchToolTypedDict] | List of search tool configurations for Search API integration. Each tool specifies a search_tool_name and litellm_params with search_provider, api_key, api_base, etc. [Further Docs](../search/index.md) |
| guardrail_list | List[GuardrailTypedDict] | List of guardrail configurations for guardrail load balancing. Enables load balancing across multiple guardrail deployments with the same guardrail_name. [Further Docs](./guardrails/guardrail_load_balancing.md) |