3.14.0 (latest)

Squirro 3.14.0 was released on August 20, 2025.

Learn more about the Squirro Release Process.

Attention

Elasticsearch upgrade to version 9 - Manual updates and upgrades starting from Squirro 3.13.5 require careful management due to Elasticsearch infrastructure changes. Before switching to 3.14.0, ensure you prepare your infrastructure. Refer to the Elasticsearch Migration page for detailed instructions on migrating Elasticsearch indices.

Notes for administrators

• Squirro Classifier and the agent configuration using the web interface are still in development. If you have suggestions for improvement, visit the Squirro Support website and submit a feedback request.

• A recent fix addressed an issue where an incorrect prompt was added to paragraphs-to-be-embedded and will cause new ingested embeddings to differ slightly from prior embeddings. After migrating to 3.14.0, if you notice a significant impact on retrieval quality, a re-embedding of the paragraphs may be necessary to improve accuracy. For assistance, visit the Squirro Support website and open a technical support request.

Note for developers

To maintain compatibility with the recent dashboard selections rewrite, custom widgets in the Squirro platform require updates. Frontend developers should plan to replace deprecated methods and update widget code to align with the new architecture. For assistance, contact Squirro Support and open a technical support request to receive guidance from experts.

What’s New

• GenAI /v0/tools/available/{tool_id} endpoint to get detailed information about a specific tool.

• GenAI /v0/tools/execute endpoint for synchronous standalone tool execution.

• GenAI /v0/tools/available endpoint to list all available tools with metadata and configuration schemas.

• Extended deploy_as_agent_tool decorator with example_inputs parameter for dynamic API documentation

• GenAI retriever for search evaluation. Support for multiple configurations, per-experiment agent_id override for testing different agents.

• Structured request/response models with Pydantic validation for tool execution.

Improvements

AI

• Enable GenAI service API access for configured clients by default.

• Support for GPT-5. Temperature and top_p params will now be filtered out, as OpenAI no longer supports it. Added “minimal” reason_effort for newer GPT-5 models.

• Multimodal image reasoning for highly relevant pages, enabling more accurate answers from structured information contained in tables, charts, and images. Activate via the ImageReasoning option in the Squirro Retriever tool.

• Add required genai steps to datalaoder pipeline workflows.

• API documentation with additional examples for tools.

• Maintained backward compatibility by preserving the legacy /v0/available_tools/ endpoint with a deprecation notice.

Search

• Synonym expansion now applies both to full terms and to detected sub-tokens. For instance, with a configured synonym rule like [jonagold, apfel], a search for jonagold also matches documents containing only the term Apfelbaum, thanks to its sub-token apfel being matched by its synonym jonagold.

• Sub-token aware text analyzers to improve lexical search, particularly for compound words in Germanic languages. For example, the compound word Apfelbaum (apple tree) is now analyzed into [apfelbaum, apfel, baum], making it more effectively searchable.

• Search Evaluation plugin supports now to 1) Curate Evaluation Sets, 2) Run experiments on curated Evaluation Sets and 3) perform comprehensive analysis on the quality of each search approach within an experiment.

• Use a secondary, tie-breaking sorting in relevancy to improve search results stability.

• Unified Term Analysis for Hyphens, Underscores, and CamelCase. Elasticsearch analyzers have been improved to normalize common variations in term formatting. Terms like WiFi, wi-fi, Wi_fi, and similar variants are now analyzed in a consistent way, ensuring that a user search for wifi will match all of them.

• Search evaluation framework support to track current progress of actively executed experiments. It allows the Search Evaluation Studio plugin to stream updates to the UI and render a summary of the current experiment in a progressbar.

Platform

• Using FastAPI Body with openapi_examples for proper Swagger UI documentation.

• Automatically set the data source title based on the uploaded filename for file-based connectors.

• Show current workspace in the project selector if Workspaces is enabled.

• Display a dialog with a warning when a user tries to create a new collection when they already have one with this name in a given project.

• Add labeled_content, offset_start, offset_end, and bounding_boxes fields to the SetException model. These fields enable the frontend to render highlights and bounding boxes for validation exceptions. Maintains backward compatibility by making new fields optional in the base class. Ensures SetExceptionContent properly requires the labeled_content field.

• Prevent users from creating a new collection if they already have one with the same name in the project.

Bug Fixes

• Error for changing the workspace role for the cluster admins.

• Entities bouding boxes improper rendering in the Item Detail view, when using Squirro Classifier.

• Chat-denied profile breaking search when applied within a rank-by clause.

• Empty queries treated as match-all not respecting additional ranking signals.

• Missing label ID for Squirro Classifier Fastpass suggestions from linked categories where the text does not match the label name, which impeded creating label from suggestion.

• Unique-term filter from a previous analyzer chain rework causing problems with highlighting, phrase queries and general relevance.

• Rheininsight plugin errors during creation following changes to the platform code due to a missing call to the parent constructor.

• machinelearning service not starting on Squirro 3.13.6 when the machinelearning database is a PostgreSQL database.

Known Issues

• In specific scenarios, cross-lingual information retrieval for semantic search may deliver lower-than-expected quality (SQ-28171).

• When closing the Project Configuration dialog in the chat dashboard, a “Discard changes” modal may appear even when no changes were made (SQ-29386).

Installation and Upgrade

For new installations, find step-by-step instructions on the Install and Manage Squirro with Ansible page (recommended) and Installing Squirro on Linux pages.

To upgrade an existing installation, see the Upgrading Squirro page.