Skip to main content

Interceptor Templates

About Interceptor Templates

An interceptor template is a reusable blueprint for creating interceptors in DIAL. It allows to save time on similar interceptors configuration.

Refer to Interceptors to learn more.

Main Screen

On the main screen, you can add and manage Interceptor Templates you have in your DIAL instance.

Interceptor Templates Grid

FieldDefinition
Display nameA user-friendly label for the interceptor template (e.g. “PII Obfuscator”, "Words Blacklist", etc.). Helps you pick the right one when configuring an interceptor.
IDThe unique identifier used internally.
DescriptionFree-text notes about the interceptor template and how it can be used.
Updated timeTimestamp for changes tracking and audit evidence (e.g., to verify when the last change was done).

97.png

Create

On the main screen of Interceptor Templates, you can create a new interceptor template by following these steps:

  1. Click + Create to invoke the Interceptor Template modal.

  2. Define key parameters for the new interceptor template:

    FieldRequiredDefinition
    IDYesThe unique identifier used internally.
    Display nameNoA user-friendly label for the interceptor template (e.g. “PII Obfuscator”, "Words Blacklist", etc.). Helps you pick the right one when configuring an interceptor.
    DescriptionNoFree-text notes about the interceptor template and how it can be used.
  3. Once all required fields are filled, click Create. The dialog closes and the new template configuration screen is opened. A new template will appear immediately in the listing once created. It may take some time for the changes to take effect after saving.

    98.png

Delete

To delete an interceptor template, follow these steps:

  1. From the main screen, select the interceptor template you want to delete by clicking on its row.
  2. Click the Delete button in the top-right corner of the configuration screen.
  3. A confirmation dialog will appear. Review the information carefully, as deleting an interceptor template will also remove all related interceptors bound to it.
  4. If you are sure you want to proceed, click Delete in the confirmation dialog. The interceptor template and all related interceptors will be permanently removed from the system.

IMPORTANT: This action is irreversible. Ensure that you have reviewed all dependencies before confirming the deletion.

Configuration

Click on an interceptor template from the main screen to open its configuration screen.

Top Bar Controls
  • Create Interceptor: Creates an interceptor with the current interceptor template. Created interceptor can be found in Entities -> Interceptors.

  • Save: Saves any changes made to the interceptor template.

  • Discard: Reverts any unsaved changes made to the interceptor template.

  • Delete: Permanently removes the selected interceptor template.

    IMPORTANT: All related interceptors still bound to it will be deleted as well.

Properties

In the Properties tab, you can preview and modify identity, metadata and endpoints of interceptor template.

Header (non-editable):

FieldDefinition
IDRead-only unique ID of the template (copyable). Cannot be changed after interceptor template is created.
Updated TimeTimestamp for changes tracking and audit evidence (e.g., to verify when the last change was done).
Creation TimeTimestamp of when Interceptor Template was created.

Fields:

FieldRequiredDefinition
Display nameYesA user-friendly label for the interceptor template (e.g. “PII Obfuscator”, "Words Blacklist", etc.). Helps you pick the right one when configuring an interceptor.
DescriptionNoFree-text notes about the interceptor template and how it can be used.
Completion endpointNoThis is the endpoint used by DIAL Core to manage chat completion requests from interceptors.
Configuration endpointNoThis endpoint is used to request interceptor's configuration parameters as a JSON schema.

99.png

Interceptors

A read-only grid showing all interceptor instances created from this template. Use it to assess potential impact before template edits or deletion.

Grid (non-editable)
FieldDefinition
Display NameDisplay name of the interceptor instance that inherits this template.
IDUnique ID of the dependent Interceptor.
DescriptionA free-text summary of the interceptor’s behavior and any configuration parameters.
Updated TimeTimestamp for changes tracking and audit evidence (e.g., to verify when the last change was done).

Audit

Activities

The Activities section under the Audit tab of a specific interceptor template provides detailed visibility into all changes made to it.

This section mimics the functionality available in the global Audit → Activities menu, but is scoped specifically to the selected template.

Activities List Table
FieldDefinition
Activity typeThe type of action performed on the interceptor template (e.g., Create, Update, Delete).
TimeTimestamp indicating when the activity occurred.
InitiatedEmail address of the user who performed the activity.
Activity IDA unique identifier for the logged activity, used for tracking and auditing.
Activity Details

The Activity Details view provides a detailed snapshot of a specific change made to an interceptor template.

To open Activity Details, click on the three-dot menu (⋮) at the end of a row in the Activities grid and select “View Details”.

Element/SectionDescription
Activity typeType of the change performed (e.g., Update, Create, Delete).
TimeTimestamp of the change.
InitiatedIdentifier of the user who made the change.
Activity IDUnique identifier for the specific activity tracking.
ViewDropdown to switch between showing all parameter or changed only.
Parameters DiffSide-by-side comparison of the fields values before and after the change. Color-coding is used to indicate the operation type (Update, Create, Delete).

100.png