Overview
This tutorial will guide you through creating a control in Galileo. By the end of this guide, you’ll know how to create, configure, and attach a control to meet your guardrail needs.Before you begin
If you want to use a control, you must attach it to an Log stream within a project. If you haven’t created a project with a Log stream, see Creating a project and Instrumentation. This tutorial assumes that:- You have installed the dependencies for Agent Control.
- You are familiar with Agent Control concepts. See Overview for more information.
Create a control from the user interface
Navigate to the Controls dashboard
In the Galileo main menu, select Controls, then Create new control.
Select the control type
Choose an evaluator type for your control.Evaluators receive data from your agent and check the data against configured rules. The evaluator you select controls your agent workflow Agent Control supports built-in and custom evaluators. See Overview for more information about the supported evaluators.
Configure the control
Add configurations to meet your guardrail needs.The following table describes the configuration fields:
For more information about the configuration fields, see Built-in Evaluators.
| Field | Description |
|---|---|
| Control name | A unique identifier for the control |
| Enabled | Toggle the control on or off |
| Stages | When to evaluate; Pre (before execution) or Post (after execution) |
| Selector path | The data path to evaluate (for example, * for all fields) |
| Action | What happens on a match. Deny blocks the request |
| Execution environment | Where evaluation runs; Server or Client |
| Evaluator configuration | Type-specific settings (values, logic, match mode, case sensitivity) |
Add the control to a Log stream within a project
In the Galileo main menu, select your Log stream. Select the Controls tab, then select Add control.A table displays with the available controls. Select Add next to your control.The control should appear in the table on the Controls tab for your project. The control takes effect immediately if your agent application is running. No redeployment is needed.
Attaching a control to a Log stream creates a clone of the control.Updating the clone doesn’t update the control for any other Log stream that uses the same control. Updating the global control in the Controls dashboard doesn’t update any existing clones.