> For the complete documentation index, see [llms.txt](https://help.bioinsight.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bioinsight.illumina.com/icm/analyses/analysis-functionality/task-menu/ask-correlation-engine.md).

# Ask Correlation Engine

{% hint style="warning" %}
AI-generated content may be inaccurate.
{% endhint %}

## What is Ask Correlation Engine?

It is a focused, read-only question-and-answer experience that helps interpret a finding from the analysis using evidence retrieved from Correlation Engine (CE). This is a research interpretation aid for research only use.

## Using Ask Correlation Engine

* Click <img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-81f23110f4555c89989d1779b492522127d6753d%2Fimage%20(573).png?alt=media" alt="" data-size="line"> at the bottom of the task graph in the Analyses tab

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-e72d869a725bc1c204b1222194721d25f7329367%2FScreenshot%202026-08-25%20160232.png?alt=media" alt=""><figcaption><p>Click <strong>Ask Correlation Engine</strong> to select a highlighted completed result to ask about it, or ask a general question</p></figcaption></figure>

Nodes that are available to be used will be colored.

* Click an available node to select the node and choose to <img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-2bd097271acc8da8777c8e01fbb2bf6a75463617%2Fimage%20(575).png?alt=media" alt="" data-size="line"> or <img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-0778b657704e1b30e7d5fbded0fef768226fa93a%2Fimage%20(576).png?alt=media" alt="" data-size="line">

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-308ac49d52599b4de8b8ad11b43eda222fa5ae6f%2Fimage%20(557).png?alt=media" alt=""><figcaption><p>Click a colored node to select the node then choose to <strong>Ask a general question</strong> or <strong>Ask about a gene</strong></p></figcaption></figure>

### Ask about a gene

* Select a gene from the list (which contains genes found in the selected node) or type a gene in the text box to find then select

{% hint style="warning" %}
Genes in the list are ordered using the p-values in the selected analysis result, lowest first.
{% endhint %}

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-a0a0240cb130a141041b259e0e424f78e8944e45%2Fimage%20(561).png?alt=media" alt="" width="375"><figcaption><p>Select a gene from the list or type a gene name to select</p></figcaption></figure>

* Click **Continue**
* Ask a question about this gene by entering it in the text box

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-4f686942dc8735f5fb5e2d7b5d5d1c30706c8c3a%2Fimage%20(559).png?alt=media" alt="" width="563"><figcaption><p>Enter a question or select one of the Questions to try then click <strong>Ask</strong></p></figcaption></figure>

* Click **Ask**

{% hint style="warning" %}
Only the gene and organism are sent to Correlation Engine. Analysis results are not sent.
{% endhint %}

The CE results are reported.

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-cd2e0bf092dfc82c4136f062dc249254b3945ad4%2Fimage%20(560).png?alt=media" alt="" width="563"><figcaption><p>The CE results are reported and can be further explored in CE using the <strong>Explore in Correlation Engine</strong> button</p></figcaption></figure>

{% hint style="warning" %}
The CE Body Atlas includes normal tissue expression data. No disease data is present in the Body Atlas.
{% endhint %}

### Ask a General Question

* Ask about a gene, SNP, tissue, or cell type.

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-ee46de83737ebb8dff019fa841ca7cfa3dadd581%2Fimage%20(563).png?alt=media" alt="" width="563"><figcaption><p>Type a question in the text box or try one of the questions</p></figcaption></figure>

The CE results are reported can be further explored in CE using the **Explore in Correlation Engine** button.

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-297ca58e71edb999e393f77db6aabe48e0c537d2%2Fimage%20(562).png?alt=media" alt="" width="563"><figcaption><p>CE results are reported for the question asked</p></figcaption></figure>

### Ask a question for the Atlas context

If a CE Atlas node is selected, the <img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-312c075141f10d62c928d472770cfdfb9db3fb7d%2Fimage%20(565).png?alt=media" alt="" data-size="line"> button can be selected.

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-c8c0d41e7c650471d186453c4b062afb5f461fd1%2Fimage%20(564).png?alt=media" alt=""><figcaption><p><strong>Ask a question for this context</strong> (CE Atlas node)</p></figcaption></figure>

* Enter a question
* Click **Ask**

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-b29cd2ffa02ebaa58b7478172ac816a2b5b9dcb1%2Fimage%20(566).png?alt=media" alt="" width="563"><figcaption><p>Enter a question for the biological signature derived from the selected atlas and click <strong>Ask</strong></p></figcaption></figure>

{% hint style="warning" %}
Correlation Engine uses the selected biological signature as context for the question. The full analysis report is not searched, sent, or analyzed.
{% endhint %}

The CE results are reported and can be further explored in Correlation Engine.

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-6e903ff92c84730aaab53eaa2a96f4597d0482e3%2Fimage%20(567).png?alt=media" alt="" width="563"><figcaption><p>The results are reported along with evidence, limitations, and suggested next questions</p></figcaption></figure>

{% hint style="warning" %}
Do not enter personal, patient, confidential, or proprietary information. AI-generated responses may be inaccurate; verify before use.
{% endhint %}

AI features can be turned off by an administrator in the [Admin console](https://help.connected.illumina.com/account-management/admin-console).

[More information for Correlation Engine](https://support.illumina.com/sequencing/sequencing_software/basespace-correlation-engine/documentation.html) and [Correlation engine FAQs](https://accounts.public.ce.basespace.illumina.com/b/corp/faq.nb).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.bioinsight.illumina.com/icm/analyses/analysis-functionality/task-menu/ask-correlation-engine.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
