We've significantly expanded our document ingestion capabilities to support much larger files. The platform can now process documents up to **2,000 pages** and **400MB in size**, a substantial increase from the previous limits of **400 pages** and **100MB**. This enhancement allows users to work with more comprehensive documents without needing to manually split them into smaller parts.
For existing tenants, adoption of the new limits requires a manual update to the feature flags. To enable the expanded capacity, set: * `MAX_PDF_PAGES_PER_FILE_ALLOWED` to `2000` * `MAX_BYTE_SIZE_FILE_ALLOWED` to `400000000` Please note that processing performance may still slow down for documents exceeding 400 pages. Organizations with strict latency requirements should continue to divide large documents into smaller segments to maintain optimal processing speed.
Oryx by Contextual AI is now officially live, enabling teams to seamlessly integrate Contextual AI agents directly into their applications with a fully customizable, unbranded, and developer-friendly experience. Built to support enterprise engineering teams, Oryx abstracts away the complexity of connection handling, agent logic, and data flow so you can focus entirely on crafting exceptional user experiences.
Key Features
Availability
Oryx is now available as `v0.1.0`. Explore the docs and examples at [https://oryx.contextual.ai/](https://oryx.contextual.ai/)
We've refreshed the Contextual AI platform login and sign-up experience with the newly introduced Möbius imagery from our corporate website, continuing our broader effort to unify the platform's look and feel under our evolving brand identity. This update enhances visual consistency across surfaces and reflects the modernized aesthetic we're rolling out throughout the product.
The new Monitoring Page gives teams deeper visibility into how their agents and knowledge bases are performing. With built-in analytics, filters, and exportable charts, you can quickly understand usage patterns, identify issues, and track adoption across your organization.
Key Features
How To Enable
Set the feature flag `ENABLE_MONITORING_PAGE` to `on` (default: `off`). Once enabled, the **Monitoring Page** will appear under **Observability** in the sidebar.
Admins can now define custom roles with tailored permission bundles across key objects (e.g., Agents, Datastores, Billing, and other admin features). Permissions can be scoped to specific Agents or Datastores, enabling finer-grained governance by ensuring each team member has the right level of access for their responsibilities. You can also create Groups to simplify role management.
Contact your Contextual AI account manager to enable this feature.
You can now review a complete record of all sync activity across your data connectors. Each sync includes drill-down details so you can see exactly which documents failed and why. This makes troubleshooting faster and provides clearer operational insight into connector performance.
How to enable: Default on.
We've added new configuration controls that let agent developers tailor how users provide feedback. You can require feedback for every query, define your own issue labels, and adapt the workflow to match your team's QA process. These options give you more flexibility in how feedback is collected and managed.
How to enable: Default on. Go to **Agent Config → User Experience**.
We've expanded our integration ecosystem with three widely requested connectors. You can now ingest and manage documents from OneDrive, Box, and Confluence directly through your datastore, extending your retrieval pipeline with more enterprise content sources.
How to enable: **Create Datastore → Third-Party Connection**.
The platform now supports end-to-end feedback annotation. Admins can define annotation labels, tag feedback within the UI, generate basic visualizations, and export annotated data as CSV. This gives enterprise teams a centralized place to manage QA workflows, reduce tool switching, and streamline evaluation processes.
How to enable: Default on for all tenants. Access via **Agent Config → Feedback Annotation**.
Teams can now integrate their billing and consumption data into their internal tools or dashboards using the new Billing API. This enables easier reporting, monitoring, and automation around usage. Endpoint: [https://docs.contextual.ai/api-reference/billing/get-billing-metadata](https://docs.contextual.ai/api-reference/billing/get-billing-metadata)
This API-only feature lets you apply document-specific ingestion settings without modifying the global datastore configuration.
This feature is useful for documents that require customized handling—such as specialized chunking, parsing, or classification. The update affects the Ingest and List Documents endpoints.
We've refreshed the Chunk Viewer to simplify navigation and collaboration. You can now share direct links to specific documents and chunks, see the file name at the top of the page, and see a formatted "Preview" as the default view. We've also improved visibility for image captioning and added an Edit button to update chunk text more easily.
Template support is now live. You can select from existing templates or save an agent's configuration as a reusable template for future agents. This accelerates setup, ensures consistency across deployments, and simplifies onboarding for new team members.
We've added several usability improvements to streamline datastore operations. You can now filter documents by status with one click (Processed, Processing, Failed), search by filename (prefix search), and customize filters or sort by creation date, status, or name.
We've also introduced new swappable models—layout, image captioning, hierarchy, and document-naming models—to improve processing accuracy and support a wider variety of document types. These settings are available in datastore configuration and help optimize ingestion pipelines.
We've added GPT-5 as an option for all agents, giving teams access to the latest generation capabilities for reasoning, summarization, and content generation. This upgrade improves accuracy and output quality across a wide range of use cases.
Page-level chunking mode optimizes parsing for page-boundary-sensitive documents. Instead of splitting content purely by size or heading structure, this mode ensures each page becomes its own retrieval-preserving chunk unless the maximum chunk size is exceeded.
This is particularly effective for slide decks, reports, and other page-oriented content, where the meaning is closely tied to individual pages.
Page-level chunking joins existing segmentation options including heading-depth, heading-greedy, and simple-length.
To enable, set `chunking_mode = "page"` when configuring a datastore via the ingest document API or via the UI.
Query reformulation allows agents to rewrite or expand user queries to better match the vocabulary and structure of your corpus. This is essential when user queries are ambiguous, underspecified, or contain terminology not aligned with the domain.
Decomposition automatically determines whether a query should be split into smaller sub-queries. Each sub-query undergoes its own retrieval step before results are merged into a final ranked set.
Common reformulation use cases include:
Enable these features via Query Reformulation in the agent settings UI, or via the Agent API.
Today, Contextual AI announces the release of advanced datastore configuration options, enabling developers to optimize document processing for RAG-ready outputs tailored to their specific use cases and document types.
Clients can now customize parsing and chunking workflows to maximize RAG performance. Configure heading-depth chunking for granular hierarchy context, use custom prompts for domain-specific image captioning, enable table splitting for complex structured documents, and set precise token limits to optimize retrieval quality.
These configuration options ensure your documents are processed optimally for your RAG system – whether you're working with technical manuals requiring detailed hierarchical context, visual-heavy documents needing specialized image descriptions, or structured reports with complex tables.
To get started, simply use our updated Agent API and datastore UI with the new configuration parameters to customize parsing and chunking behavior for your specific documents and use cases.
Today, Contextual AI announces the release of the Chunk Inspector, a visual debugging tool that allows developers to examine and validate document parsing and chunking results.
Clients can now inspect how their documents are processed through our extraction pipeline, viewing rendered metadata, extracted text, tables or image captioning results for each chunk. This transparency enables developers to diagnose extraction issues, optimize chunking configurations, and ensure their documents are properly RAG-ready before deployment.
The Chunk Inspector provides immediate visibility into how your datastore configuration affects document processing, making it easier to fine-tune parsing and chunking settings for optimal retrieval performance.
To get started, simply navigate to the Chunk Inspector in your datastore UI after ingesting a document to review the extraction and chunking results.
Today, Contextual AI announces the Document Parser for RAG with our separate /parse component API, enabling enterprise AI agents to navigate and understand large and complex documents with superior accuracy and context awareness.
The document parser excels at handling enterprise documents through three key innovations: document-level understanding that captures section hierarchies across hundreds of pages, minimized hallucinations with confidence levels for table extraction, and superior handling of complex modalities such as technical diagrams, charts, and large tables. In testing with SEC filings, including document hierarchy metadata in chunks increased the equivalence score from 69.2% to 84.0%, demonstrating significant improvements in end-to-end RAG performance.
Get started today for free by creating a Contextual AI account. Visit the Components tab to use the Parse UI playground, or get an API key and call the API directly. We provide credits for the first 500+ pages in Standard mode (for complex documents that require VLMs and OCR), and you can buy additional credits as your needs grow. To request custom rate limits and pricing, please contact us. If you have any feedback or need support, please email [parse-feedback@contextual.ai](mailto:parse-feedback@contextual.ai).
Today, Contextual AI launched groundedness scoring for model responses.
Ensuring that agent responses are supported by retrieved knowledge is essential for RAG applications. While Contextual's Grounded Language Models already produce highly grounded responses, groundedness scoring adds an extra layer of defense against hallucinations and factual errors.
When users query an agent with groundedness scores enabled, a specialized model automatically evaluates how well claims made in the response are supported by the knowledge. Scores are reported for individual text spans allowing for precise detection of unsupported claims. In the platform interface, the score for each text span is viewable upon hover and ungrounded claims are visually distinguished from grounded ones. Scores are also returned in the API, enabling developers to build powerful functionality with ease, like hiding ungrounded claims or adding caveats to specific sections of a response.
To get started, simply toggle "Enable Groundedness Scores" for an agent in the "Generation" section of the agent configuration page, or through the agent creation or edit API. Groundedness scores will automatically be generated and displayed in the UI, and returned as part of responses to `/agent/{agent_id}/query` requests.
Today, Contextual AI announces the release of document metadata ingestion and allows for metadata-based filtering during queries.
Clients can now narrow search results using document properties like author, date, department, or any custom metadata fields, delivering more precise and contextually relevant responses.
To get started, simply use our ingest document and update document metadata APIs to add metadata to documents. Once done, use our document filter in the query API to filter down results.
Today, Contextual AI announces the release of the support of DOC(X) and PPT(X) files for ingestion into datastore.
This enables clients to leverage Microsoft Office documents directly in their RAG agents, expanding the range of content they can seamlessly incorporate.
To get started, use our document API or our user interface to ingest new files.
Today, Contextual AI announces support for filtering retrieved chunks based on the relevance score assigned by the reranker.
The ability to filter chunks based on relevance score gives users more precision and control in ensuring that only the most relevant chunks are considered during response generation. It is an effective alternative or complement to using the filter\_prompt for a separate filtering LLM.
To get started, use the `reranker_score_filter_threshold parameter` in the Create/Edit Agent APIs and in the UI.
Today, Contextual AI announces the world's first instruction-following reranker, available in both agents and as a separate /rerank component API.
The instruction-following reranker enables users to specify natural language instructions about how the reranker should rank retrievals, which improves accuracy in reranking and response generation. The reranker ranks documents according to their relevance to the query first and your custom instructions secondarily. We evaluated the model on instructions for recency, document type, source, and metadata, and it can generalize to other instructions as well. For instructions related to recency and timeframe, specify the timeframe (e.g., instead of saying "this year") because the reranker doesn't know the current date. The reranker is state-of-the-art on the industry-standard BEIR benchmark, as well as our internal benchmarks.
To get started for free with the `/rerank` component API, create a Contextual AI account, visit the Getting Started tab, and either get an API key for the `/rerank API` or use the `/rerank UI` playground. We provide credits for the first 50M tokens, and you can buy additional credits as your needs grow. To request custom rate limits and pricing, please contact us. If you have any feedback or need support, please email [reranker-feedback@contextual.ai](mailto:reranker-feedback@contextual.ai).
This reranker is the default for new agents created with the Contextual AI platform. To specify instructions, use the reranker\_instruction parameter in the Create/Edit Agent APIs and in the UI. See blog post for more details.
Today, Contextual AI announces the Grounded Language Model (GLM), the most grounded language model in the world, available in both agents and as a separate /generate component API.
The GLM is an LLM that is engineered specifically to prioritize faithfulness to the retrieved knowledge over parametric knowledge to reduce hallucinations in Retrieval-Augmented Generation. Uniquely, the model distinguishes between facts and commentary that it generates, and users can toggle an avoid\_commentary flag to determine whether the model can include commentary in its response or not.
To get started for free with the /generate component API, create a Contextual AI account, visit the Getting Started tab, and either get an API key the /generate standalone API or use the /generate UI playground. We provide credits for the first 1M input and 1M output tokens, and you can buy additional credits as your needs grow. To request custom rate limits and pricing, please contact us here. If you have any feedback or need support, please email [glm-feedback@contextual.ai](mailto:glm-feedback@contextual.ai).
The GLM is already the default model in new agents created with the Contextual AI platform. See blog post for more details.
Today, Contextual AI announces the availability of advanced parameters in agent creation and editing.
With these parameters, you can control more granular aspects of your specialized RAG agent across retrieval, reranking, filtering and generation. In particular, you can:
These controls empower you to optimize your agent according to use case-specific requirements with much greater precision, ultimately delivering more accurate and relevant responses to your users' queries.
To get started, use the `agent_configs` object in the Create/Edit Agent APIs. You can also change these parameters by editing the agent in the UI. They are subject to change.
Today, Contextual AI announced support for Agent-level entitlements.
With this release, customers can now configure access rights per-user to agents. Using the Permissions page on our platform UI, administrators can define access policies for their entire tenant or grant individual access to specific agents to specific users.
Today, Contextual AI announces the release of our new Users API to help customers manage their end-users on the platform.
Administrators can now programmatically manage user accounts through the Users API. This includes creating new users, describing users, updating user information, and removing users. In addition to the Users API, customers can also manage their end-users through the platform UI.
To get started, use the Users API today on the platform. Learn more here.
Today, Contextual AI announces the release of our new Metrics API. This endpoint provides programmatic access to an agent's query and feedback data from end-users.
With the Metrics API, developers can analyze usage and feedback, automate reporting, and set up alerts. The Metrics API returns data such as user and message information, query, response, feedback, and user-submitted details or issues with generated responses.
To get started, use the Metrics API today on the platform. Learn more here.
Today, Contextual AI announced support for multi-turn chat conversations.
With this release, agents can rely on prior conversational history and retrieved knowledge. When users ask follow-up questions, agents can automatically use information from prior turns in the conversation to resolve ambiguities in the query, fetch the appropriate retrievals, and generate the final answer.
This feature is currently available in private preview. Contact us to get access.
Today, Contextual AI announced support for many-to-many mapping between agents and datastores. Multiple datastores can now connect to multiple agents, enabling more flexible and efficient ways to build specialized RAG agents.
With many-to-many mapping, you can now connect multiple agents to multiple datastores, eliminating data silos allowing for cross-datastore access. As your system grows, agents can interact with any datastore without manual duplication or re-uploading, ensuring faster access and better efficiency.
To get started, build your first datastore today on the platform. Learn more here.
Today, Contextual AI announced support for reasoning over images in unstructured data.
Our document understanding engine can now extract and reason over charts, graphs, and other visual elements within PDF files. In addition to text, your agents can now answer queries based on the content of images in PDF files.