3.13.3 (latest)#

Squirro 3.13.3 was released on May 19, 2025.

Learn more about the Squirro Release Process.

Notes for administrators

  • The agent configuration using the web interface is still in development. As we continue to refine and improve it, you may encounter some inconsistencies or issues. Your feedback is really important to us in making this feature the best it can be. If you experience any problems or have suggestions for improvement, visit the Squirro Support website and submit a feedback request.

  • This release introduces important changes that may require adjustments to your existing setup. Learn more

What’s New#

  • The search service is now publicly accessible via the /search/service URL.

  • Personally Identifiable Information (PII) detection and masking capabilities implemented.

  • New Highlight option for QueryLens.

  • Updated the Squirro Python client to include access to search service endpoints.

  • Added the additional_filter_query tool option, allowing users to set an extra Squirro query for filtering results, such as targeting a specific data source.

Improvements#

  • Support for SharePoint Lists.

  • generated_summary added to the list of fields returned by the Item Details API.

  • Adjusted JavaScript code and function calls to enhance security and improve page performance.

  • Preloading capabilities for the chat widget.

  • Improve handling of different kinds of filters when chatting with search results and favorites, and with any forward combination with agent filters.

  • Support for Markdown in the disclaimer text of the Chat widget.

  • Stabilized paragraph highlighting by displaying full paragraph bodies in the left pane (sidebar) and generating more and longer sentence fragments, which are used to improve sentence highlighting in PDFs.

  • The Content Extraction step removes soft hyphens from the extracted text.

  • An administrator can configure multiple squirro-retriever instances, each one with custom settings like filtering for a specific data source. Those settings effectively override the default retriever settings defined in genai.sqgpt.squirro-retriever-settings.

  • Default toolkit specs also created during the creation of default agents.

  • Data Ingestion structured logs now include the hostname and processor_name labels for better traceability. hostname is the hostname of the node where the ingester processor was running and processor_name is the name of the ingester processor that emitted the log (for example, processor_1 unstructured logs are located at /var/log/squirro/ingester/processor_1/processor.log*).

  • The Indexing step now always emits an End batch structured log, including the raised exception when it fails to process the batch.

  • Ability to copy ID to clipboard for sources, pipelines, and items.

  • Paragraph Highlighting of Cited Documents: Moved to LLM driven selection of best paragraphs (dynamically populated paragraph-highlighting hyperlinks). Before, the first paragraph in the context-section was highlighted (confusing users), now the most relevant paragraph (according to LLM) is highlighted.

  • Support for the o-model family from OpenAI.

  • Access studio plugins for a workspace admin.

Bug Fixes#

  • Removed unused template usage in CommunitiesWidget.

  • RTE widget toolbar is not always visible.

  • Incorrect count showing for labels widget in single dropdown mode.

  • genai Alembic migration not working on Postgres database when upgrading from genai<=3.12.1 to genai>=3.13.0.

  • Date time selection popup cut off on small screens.

  • Mechanism to check environment variables exist and are not empty.

Known issues#

  • Labels with technical names containing spaces cause backend issues and errors (SQ-26080).

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

  • Cannot open the Squirro item from the inline citations when using Batch Q&A (SQ-28528).

  • The warning for the filter change is malpositioned when using the copilot mode (SQ-28527).

  • The Agents dropdown menu is overflowing when in copilot mode (SQ-28522).

  • The agent and dashboard filters in the chat may not handle broad queries optimally, limiting results more than intended (SQ-28627).

Breaking Changes#

  • Setting an additional query on the agent is no longer supported, use additional_filter_query on the Squirro retriever instead.

  • Introduced SQ_SECURITY_WORKSPACES environment variable for genai service Docker image that is required for some platform-related features like document summary storage and ML workflows execution. The value must be the same as the value of security.workspaces for the connected Squirro Platform (which is false by default).

  • The Default grounding mode configuration setting offering the choice between strict or lenient no longer exists in the project configuration in Squirro Chat. The system now enforces the strict mode by default at the tool level when configuring an agent and applies it automatically without user intervention or control.

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.