Using AI Assistant Search

Overview

AI Assistant Search offers a faster and more intuitive way to find what you need in TOS. You can simply enter your query in natural language — and AI Assistant Search automatically generates the equivalent TQL query, runs it, and displays the results for you.
AI Assistant Search securely processes queries according to Tufin’s data privacy and security standards.

For information on the AI Assistant Search components and how it works, review the architecture and data flow.

Features

  • Seamless switch to AI Assistant Search

    In TOS, seamlessly switch to AI Assistant Search with a single click.

  • Natural language queries

    Type what you are looking in plain text, as questions or phrases or sentences. See Tips for natural language queries.

  • Automatic TQL generation

    AI Assistant Search automatically transforms your natural language query into the corresponding TQL command.

  • Continuous improvement through feedback

    An intuitive feedback option helps us improve the accuracy and quality of AI Assistant Search.

Data, Privacy, and Security

  • AI Assistant Search collects data for performance analysis and internal software improvements.

  • All sensitive data is encrypted with restricted access.

  • Customer data is not used to train or develop the AI Assistant Search models.

  • There is no direct connection to the cloud: the connection is established through the browser, which acts as a proxy between the Tufin Cluster and Tufin Cloud.

Prerequisites

  • Cloud access from browser to https://ai-powered-search.tufin.com/tql-translation/health via HTTPS (TCP 443)

  • TOS version R25-2 GA or higher

  • AI Assistant Search enabled by a super admin

  • Dedicated customer account with a valid license for SecureTrack. An evaluation license is also considered valid.

    If there are issues with the license, the Search with AI button in the UI is disabled.

Enable/Disable AI Assistant Search

Enable AI Assistant Search via the command line to use it in the features where available, such as the Rule Viewer, and disable it as needed.

Only super admins can enable or disable AI Assistant Search.

Enable AI Assistant Search

  • Run the following commands:

tos config set -s ai-powered-search -p enabled=true -f
tos config set -s ai-powered-search-ui -p enabled=true -f

Disable AI Assistant Search

  • Run the following commands:

cd installation/
sh uninstall.sh

Tips for Natural Language Queries

AI Assistant Search uses Google’s Gemini as its LLM, supporting all operators.
Here are general guidelines for using AI Assistant Search and natural language queries.
The examples are feature agnostic. For feature-specific examples, see Rule Viewer.

  • Natural language phrasing

    Use everyday language and clear, conversational phrasing.

    For example, instead of updated records status active, try:
    Show me all records that were updated in the last week and still have an active status

  • Start with an action

    Start your prompt with a clear action word like Show me, List, Find.

    For example, instead of just disabled rules, try:

    Find all disabled rules

  • Use precise terms

    To make results more accurate, include specific identifiers, such as a device name, domain name, or type.

    For example, instead of find all PROD devices, try:
    Find all devices in PROD domain

  • Rephrase and refine your prompts

    If the results from AI Assistant Search are not what you expected, try adjusting your wording or using alternate terms to help it better understand your intent.

    For example, if recent activity for rules gives results that are too broad, try narrowing it to:
    List all rules modified in the past week

  • Share your feedback

    Sharing your input with context how well the generated TQL queries meet your needs helps us refine the AI Assistant Search experience and enhance its accuracy.

Use AI Assistant Search

When enabled, AI Assistant Search is available in TOS for several features such as the Rule Viewer.

If there are issues with your license, the Search with AI button is disabled. For help, contact Tufin support.

  1. Go to the feature where you want to use AI Assistant Search.
    For example:

    SecureTrack > Browser > Rule Viewer.

  2. Click Search with AI.

  3. Type your query as free text (natural language), and then press Enter or click Generate query.
    The free text query is converted into a TQL query, and the matching results are displayed.

    The example below shows the natural language query and the generated TQL query with the matching results in the Rule Viewer.

  4. To provide feedback on the quality of the results, click the thumbs-up or the thumbs-down icons, adding additional context if needed.

    To learn how your feedback is used, hover over the info icon to the left of the feedback icons.