Articles in this section

Create a guardrail

Guardrails help you protect your flow by checking each record for safety and compliance as it runs. It works in real time and can be placed before or after an AI agent, or anywhere in the flow.

Create a Celigo guardrail as a new import model type:

  • Navigate to AI studioCreate Guardrail. Click + Create guardrail in the upper right side of the Guardrails page.

    AIstudio_guardrails.jpg
  • Alternatively, you can add a guardrail in Flow builder. Open BuildFlow builder, click the + button,and select Add guardrail.

    Flowbuilder_guardrail.jpg

Configure the guardrail

While navigating through a flow, in the Create guardrail panel after you provide a name and an optional description, click Next. The settings expand to allow you to configure the guardrail.

  1. Name your guardrail: Enter a clear and reusable name for your convenience when referencing it from other parts of the application.

  2. Description (optional) - Describe what the guardrail checks and where it should be used (pre- or post-agent). Keep this description updated as you make changes.

  3. Guardrail type: Select one policy mode and configure its settings:

    guardrail_type.jpg
    • PII - Personally identifiable information (PII) helps you detect, mask, or block sensitive information in real time, ensuring only compliant data is processed by your AI agent.

      • Set Confidence threshold (required)

      • Under the Categories, select PII entities/categories to detect and protect

      • You can optionaly mask the detected entities

      • Click Save & close

    • Moderation: You can either select Use native guardrail or Bring your own key.

      Guardrailtype_moderation.jpg
      • Select an OpenAI connection from the Connection list or add one. (The Use native guardrail option is available only for BYOK.)

      • Set the mandatory Confidence threshold.

      • Select Categories of PII entities.

      • Click Save & close.

    • Custom prompt check - You can select either Celigo AI or Bring your own key.

      Guardrailtype_custom_prompt_check.jpg

      Note

      By default, Celigo AI is selected.

      • Select an OpenAI connection from the Connection list or create another connection. (This option is available only with BYOK.)

        BYOK_Gemini.jpg

        Note

        If you prefer to use your own connection (BYOK), you can attach either an OpenAI or Gemini connector. The list is then automatically populated with all supported models available through that connection.

      • Select one of the AI model selection options. These models run under the Celigo-managed account:

        • OpenAI - gpt-5, gpt-5-pro, gpt-5-mini, gpt-5-nano, gpt-4.1, gpt-4.1-mini (default), and gpt-4.1-nano

        • Gemini - gemini-2.5-pro, gemini-2.5-flash-lite, gemini-2.5-flash, and gemini-2.5-flash-image

        Guardrail_AI_Model.jpg
      • Set the Confidence threshold (if applicable).

      • Click Save & close.

Preview guardrails

The guardrails wizard includes:

  • Configuration panel (left)

  • Preview panel (right)

Preview allows you to:

  • Provide mock input data. To see how import requests will look during configuration, click within the Input panel.

  • In Output, click Send to review the structured JSON output that will be available to downstream mappings/transformations.

The Mock response panel works similarly across the Celigo platform. You can reference and provide mock response data, as described elsewhere, also for guardrails.