# Setting Probes

If you wish to see the state of data at a given chain point, right click the chain point and select **New probe…**

<figure><img src="/files/MX4JsoEdBRFzepDHr4Y4" alt=""><figcaption><p>new probe...</p></figcaption></figure>

The following dialog box appears:

<figure><img src="/files/wTIabs9eymKgYRjx30wT" alt=""><figcaption><p>Dialog</p></figcaption></figure>

To set a probe, you can specify CSV lists of variables and values that must be matched *(or you can leave the fields blank to have the probe trigger on the next transaction through that chain point).*

Variable can be surrounded by various special characters to indicate additional criteria. For example, consider a variable named VAR:

* `VAR` : means that VAR is equal to the selection value (exact match)
* `!VAR` : means that VAR is not equal to the selection value
* `VAR*` : means that the VAR content starts with the selection value
* `*VAR` : means that the VAR content ends with the selection value
* `*VAR*` : means that the VAR content contains the selection value
* `VAR<` : means that the VAR content is less than the selection value
* `VAR>` : means that the VAR content is greater than the selection value

For the `<` and `>` characters, the value will first be attempted to convert to a number. If that succeeds, numeric comparisons are performed. If not, a lexical comparison will take place.

**Tip:** the value field is matched literally. Setting variable `VAR` with the value left blank only matches transactions where VAR is itself empty. To match *any* value of VAR (i.e. trigger whenever the variable is present), use `*VAR*` with the value left blank: the contains-match treats an empty target as always present.

You can also select the occurrence number of the probe to see. This is especially useful when debugging loops.

By default, only the first 100 characters of any variable is recorded.

Once the probe is set, the chain point changes color to yellow:

<figure><img src="/files/DBMaqDc5jkzWMAZGuta3" alt=""><figcaption><p>chain point in yellow color</p></figcaption></figure>

It will stay yellow until a matching transaction reaches the chain point, at which point it will turn red:

<figure><img src="/files/zGiBvN1NoQmKZRaMwYiu" alt=""><figcaption><p>chain point in red color</p></figcaption></figure>

You can now see the variables as they were when they reached the probe. To do this, right click on the chain point again and select **View probe**:

<figure><img src="/files/OxgaXhB4vpNd2cq80Sk6" alt=""><figcaption><p>View probe</p></figcaption></figure>

A dialog box appears with the variable information:

<figure><img src="/files/yvt1y8UzyRdxBksdFgsK" alt=""><figcaption><p>variable information in a dialog</p></figcaption></figure>

To close the dialog box, click the X in the top right corner.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tomorrowx.com/cap/product-reference/live-performance-data-and-probes/setting-probes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
