Document Diversity
- Cap one document’s share of the ranked list:
max_chunks_per_documenton the v3 Query request stops a single long file from occupying every result slot. Surplus chunks drop and the page backfills with the next best chunks from other documents; ranking is unchanged, only the page composition is.
Same day: Studio Improvements, Terminal Job Stages
Studio Improvements
- Indexing options on Home: a popover next to the Advanced / Basic choice sets Mask PII (
mask_pii), skip or overwrite existing files (skip_existing/overwrite_existing), tags (custom_metadata, with reserved and$-prefixed keys rejected as you type), and the spoken language for audio and video (transcription_language). Remember for this collection keeps the processing type, Mask PII, and skip/overwrite choice as the collection’s defaults, and Google Drive, SharePoint, and Dropbox continuous syncs re-index with them. New source tiles cover URLs, YouTube (transcript, audio, or video mode pluson_missing_transcript), and S3, GCS, Azure Blob, R2, Supabase, and Backblaze, all without an API key in the browser. - Search settings in the chat: results per collection, rerank on/off with the model (
voyage-rerank-2.5,voyage-rerank-3,gemini-2.5-flash,gemini-3.8-flash) and candidate limit, the keyword ↔ semantic balance (semantic_ratio), skipped chunk types, archived documents, and a metadata filter, remembered per organization in the browser. The view code panel now shows the v3 Query request the settings produce, next to the v2 answer mode, with a parameter table. - Playground covers every public endpoint: v3 Query with
semantic_ratio, rerank Off / On / Custom,exclude_chunk_types,boost, allincludekeys, and relations; v2 Query; query history list and get (byquery_idorrequest_id); multipart file upload; parsing script validation; document page, asset URLs, and metadata; Azure Blob sync create and a credentials check; job PII report get and delete; feedback. Query cards render a ranked results view with total, server time, rerank model, andquery_id, and every card exports cURL, Python, and TypeScript. - Sync Manager: Azure Blob Storage as a provider (
container,account_name,account_key, with Event Grid guidance in the Webhook dialog), tags on create, Rotate secret for webhooks (rotate_secret), and an Environment choice on the create form. Syncs stay organization-wide; the choice picks the target collection’s environment, and an API key must exist there (412otherwise). - Activity: Cancel job for running or queued jobs (
DELETE /v2/jobs/{job_id}) and Roll back for finished ones (PATCH /v2/jobs/{job_id}/rollback); a PII masking row with the report state and theGET /v2/jobs/{job_id}/piicall; file rows that expand to URI, document id, status, stage, error, and update time. - API Keys and usage: renaming a key persists, Rotate key reveals the new secret once and retires the old one immediately, and the sidebar usage figure sums the current billing period from the same source as the Usage page.
- Faster chunk and document reads:
GET /v3/collections/{collection_name}/chunksandGET /v3/collections/{collection_name}/documents/{document_id}no longer transfer each chunk’s stored embedding from the index before dropping it. A 100-chunk page went from about 3 s to under a second, and a 317-chunk document from 9 s to under half a second, with the same response bodies. The same routes back the Playground’s document and chunk cards and the MCPcaptain_list_chunkstool.
Terminal Job Stages
- Jobs report a terminal stage: a finished job’s
progress.current_stagenow ends atcompleted,failed, orcancelledinstead of sitting onfinalizingforever, and per-filestagevalues end atcompleted(indexed or skipped; the file’sstatuscarries which) orfailed. A job whose files all failed now saysJob failedrather thanJob completed.
Same day: Studio Improvements