feat: configurable Cohere reranker URL (Azure AI support)#12969
Open
npeham wants to merge 1 commit into
Open
Conversation
Mirror the Jina reranker pattern by adding an optional cohereApiUrl
field across the web search auth pipeline so Cohere-compatible
endpoints (e.g. Azure AI serverless) can be targeted instead of the
hardcoded Cohere API URL.
- packages/data-schemas: register cohereApiUrl as optional reranker
key and add ${COHERE_API_URL} placeholder default in
loadWebSearchConfig.
- packages/data-provider: extend webSearchSchema with cohereApiUrl.
- packages/api: include cohereApiUrl in the user-provided URL set so
the value is gated by SSRF preflight before being passed to the
reranker.
- client: surface the URL input in ApiKeyDialog and propagate it
through useAuthSearchTool form state.
- locales: add com_ui_web_search_cohere_url and
com_ui_web_search_reranker_cohere_url_help English keys.
- .env.example: document COHERE_API_URL alongside JINA_API_URL.
- tests: extend data-schemas and packages/api specs to cover the
new optional URL key.
Refs danny-avila#12328
https://claude.ai/code/session_016h4wbHY2VKPiFnd1krqies
This was referenced May 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements #12328
This PR adds support for an optional custom Cohere API URL configuration, allowing users to specify alternative Cohere endpoints (e.g., Azure AI serverless deployments or self-hosted instances). This mirrors the existing optional URL configuration already available for Jina.
The changes include:
cohereApiUrlas an optional configuration field in the web search schemaChange Type
Testing
Existing unit tests have been updated to verify:
cohereApiUrlis properly marked as optional (value 0) in the web search auth schema${COHERE_API_URL}when not providedAll updated tests in
packages/api/src/web/web.spec.tsandpackages/data-schemas/src/app/web.spec.tspass with these changes.Checklist