> For the complete documentation index, see [llms.txt](https://academy.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.pentaho.com/solution-analyst-path-sandbox/solution-analyst.md).

# Solution Analyst

The Certified Solution Analyst learning path: five courses in a set order — Business Analyst, then the four Analytics Developer courses — leading to the certification.

{% hint style="warning" icon="eye" %}
**SANDBOX — draft page.**

For review only. The Certified Solution Analyst learning path is the analytics counterpart of the Solution Architect path: five mandatory courses in a set order — Business Analyst, then the four Analytics Developer courses: Schema Workbench, Metadata Editor, Report Designer and CTools — leading to the certification. The course outlines are generated from Pentaho Content Manager.
{% endhint %}

<p align="center"><i class="fa-magnifying-glass-chart">:magnifying-glass-chart:</i></p>

<h2 align="center">Pentaho Solution Analyst</h2>

<p align="center">Own the analytics layer end to end — build the reports, analyses and dashboards business users work in, then the cubes, metadata domains, reports and dashboards underneath them.</p>

{% columns %}
{% column %}

<p align="center"><i class="fa-layer-group" style="color:blue;">:layer-group:</i><br><strong>5 courses</strong><br><em>in a set order, then certification</em></p>
{% endcolumn %}

{% column %}

<p align="center"><i class="fa-list-check" style="color:green;">:list-check:</i><br><strong>101 lessons</strong><br><em>across 38 modules</em></p>
{% endcolumn %}

{% column %}

<p align="center"><i class="fa-cloud" style="color:cyan;">:cloud:</i><br><strong>Hosted labs</strong><br><em>you report, model and build</em></p>
{% endcolumn %}
{% endcolumns %}

{% hint style="success" icon="chart-mixed" %}
**A set path, built on Business Analytics.**

Like the Solution Architect path, there is no choice of level: every Solution Analyst takes the same five courses in the same order. You start as a Business Analyst in the User Console, then take the four Analytics Developer courses — Schema Workbench, Metadata Editor, Report Designer and CTools — to build what those tools run on. Where the Solution Architect owns the platform, the Solution Analyst owns what runs on it.
{% endhint %}

```mermaid
%%{init: {"theme":"base","themeVariables":{"fontFamily":"Arial, Helvetica, sans-serif","fontSize":"13px","lineColor":"#64748b","clusterBkg":"#fafaf9","clusterBorder":"#d6d3d1","edgeLabelBackground":"#ffffff"},"flowchart":{"curve":"basis","nodeSpacing":28,"rankSpacing":44,"padding":22,"wrappingWidth":600,"htmlLabels":true}}}%%
flowchart TB
  classDef tool fill:#dbeafe,stroke:#1d4ed8,color:#1e3a8a,text-align:left,rx:6,ry:6
  classDef model fill:#ccfbf1,stroke:#0f766e,color:#134e4a,text-align:left,rx:6,ry:6
  classDef dev fill:#ede9fe,stroke:#6d28d9,color:#3b0764,text-align:left,rx:6,ry:6
  classDef check fill:#fef3c7,stroke:#b45309,color:#78350f,text-align:left,rx:6,ry:6
  BA["<b>1 · Business Analyst</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>Business Analytics · a hosted lab&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>reports and dashboards in the User Console&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"]:::tool
  SW["<b>2 · Schema Workbench</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>Solution Analyst · course 2 of 5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>Mondrian cubes for Analyzer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"]:::model
  ME["<b>3 · Metadata Editor</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>Solution Analyst · course 3 of 5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>metadata domains for Interactive Reports&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"]:::model
  RD["<b>4 · Report Designer</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>Solution Analyst · course 4 of 5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>print-quality, parameterised reports&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"]:::dev
  CT["<b>5 · CTools</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>Solution Analyst · course 5 of 5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>fully custom dashboards&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"]:::dev
  CE["<b>Certified Solution Analyst</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>all five mandatory courses&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br/>plus a proctored exam&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"]:::check
  BA -->|"what the User Console runs on"| SW
  SW -->|"cubes, then domains"| ME
  ME -->|"a data source for reports"| RD
  RD -->|"beyond fixed reports"| CT
  CT --> CE
```

<p align="center"><em>Each course builds on the one before it — from the reports business users see, down to the cubes, domains and dashboards underneath them</em></p>

{% hint style="info" icon="user-shield" %}
**The certification exam is proctored.** Certified Solution Analyst means all five mandatory courses plus a proctored exam. The exam is delivered through Kryterion's Webassessor platform, online from your own computer or at a Kryterion-authorised test centre. Online, you install Kryterion's secure browser beforehand, show government photo ID that matches your Webassessor account, pan your webcam around the room, and are watched for the whole session by a proctor backed by AI monitoring. No notes, second screens or outside help. The open-book course exams inside the Lab Guide are not proctored. REPLACE-ME — confirm exam length, pass mark, fee and the retake policy.
{% endhint %}

***

<h3 align="center">The learning path</h3>

<p align="center">Take the courses in this order. Each step opens the course outline — the same sequence the Lab Guide shows inside every course.</p>

{% stepper %}
{% step %}

### <i class="fa-chart-pie-simple" style="color:blue;">:chart-pie-simple:</i> Business Analyst

`Course 1 · 15 lessons · 6 modules · ~6h 40m`

The User Console tooling business users work in: Interactive Reports, Analyzer and Dashboard Designer on the Steel Wheels sample data, ending in the APAC Sales Pack capstone. The same course that opens the Business Analytics path.

<a href="https://academy.pentaho.com/solution-analyst-path-sandbox/solution-analyst/business-analyst.md" class="button primary" data-icon="arrow-right">Open the Business Analyst outline</a>
{% endstep %}

{% step %}

### <i class="fa-cubes" style="color:blue;">:cubes:</i> Schema Workbench

`Course 2 · 18 lessons · 9 modules · ~11h`

The second of the five courses on the Solution Analyst path. Build, extend and publish the Mondrian cubes Analyzer queries — dimensions, hierarchies, measures, calculated members and named sets — then query them in MDX, secure them with Mondrian roles, localise them and speed them up with aggregate tables, ending in a Budget v Actual schema of your own.

<a href="https://academy.pentaho.com/solution-analyst-path-sandbox/solution-analyst/schema-workbench.md" class="button primary" data-icon="arrow-right">Open the Schema Workbench outline</a>
{% endstep %}

{% step %}

### <i class="fa-sitemap" style="color:blue;">:sitemap:</i> Metadata Editor

`Course 3 · 13 lessons · 6 modules · ~9h 15m`

Build the metadata domains Interactive Reports are built on: physical layer, business models and views, inherited properties, reusable concepts and row-level security, ending in the Trailhead Outfitters capstone.

<a href="https://academy.pentaho.com/solution-analyst-path-sandbox/solution-analyst/metadata-editor.md" class="button primary" data-icon="arrow-right">Open the Metadata Editor outline</a>
{% endstep %}

{% step %}

### <i class="fa-file-invoice" style="color:blue;">:file-invoice:</i> Report Designer

`Course 4 · 39 lessons · 11 modules · ~15h 30m`

Print-quality, parameterised reports: data sources and queries, groups, totals and conditional formatting, parameters, charts, drill-down and sub-reports, publishing with hyperlinks and bursting by territory, ending in the Regional Sales report capstone.

<a href="https://academy.pentaho.com/solution-analyst-path-sandbox/solution-analyst/report-designer.md" class="button primary" data-icon="arrow-right">Open the Report Designer outline</a>
{% endstep %}

{% step %}

### <i class="fa-chart-pie" style="color:blue;">:chart-pie:</i> CTools

`Course 5 · 16 lessons · 6 modules · ~7h 55m`

Fully custom dashboards: CDA data sources, CDF and CDE dashboards with CCC charts, and CGG graphics, ending in the Retail Sales analysis dashboard.

<a href="https://academy.pentaho.com/solution-analyst-path-sandbox/solution-analyst/ctools.md" class="button primary" data-icon="arrow-right">Open the CTools outline</a>
{% endstep %}

{% step %}

### <i class="fa-award" style="color:orange;">:award:</i> Certified Solution Analyst

`Certification · proctored exam`

Certification is all five mandatory courses plus a proctored exam. With the courses complete, you book and sit the exam through Kryterion's Webassessor — see the box at the top of this page for what that involves.
{% endstep %}
{% endstepper %}

{% hint style="info" icon="sparkles" %}
**Going further — Speciality courses, coming soon.** Five optional Specialities build on the path: Semantic Model Editor, Embedded Analytics, Analytics Performance, Multi-tenant Analytics and Preparing Data for Analytics. They are not part of the certification.

<a href="https://academy.pentaho.com/solution-analyst-path-sandbox/speciality-courses.md" class="button secondary" data-icon="sparkles">See the Speciality courses</a>
{% endhint %}

***

<h3 align="center">Is this path for you?</h3>

{% columns %}
{% column %}
{% hint style="success" icon="circle-check" %}
**Yes — if you**

* Own the analytics layer end to end — the models as well as the reports
* Are the person others ask what a measure actually means
* Design the cubes, dashboards and models other analysts build on
* Want a certification that says so
  {% endhint %}
  {% endcolumn %}

{% column %}
{% hint style="info" icon="signs-post" %}
**Try another path if you**

* Build reports and dashboards in the User Console, and that's the job — **Business Analytics**
* Design and run the platform itself — **Solution Architect**
* Build the pipelines that feed the reports — **PDI Developer**
  {% endhint %}
  {% endcolumn %}
  {% endcolumns %}

***

<h3 align="center">How to get access</h3>

{% stepper %}
{% step %}
**Read the course outlines**

Open each step of the path above and check the modules cover the reports, models and tools you'll work with.
{% endstep %}

{% step %}
**Talk to your Pentaho Account Executive**

Courses and subscriptions are purchased through your Pentaho Account Executive — a single seat or the whole team. They'll size it with you and get the order placed. No Account Executive yet? Email <academy@pentaho.com> and we'll connect you.
{% endstep %}

{% step %}
**Receive your voucher code**

You'll be sent a voucher code giving access to the course or courses you bought.
{% endstep %}

{% step %}
**Redeem your code and start your lab**

Redeem the code on the Pentaho training portal and your hosted lab deploys with the Lab Guide built in. Every screen is shown step by step in the voucher walkthrough.

{% embed url="<https://pentaho.selfpaced.training/access/login>" %}

<figure><img src="https://2974708810-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD8OCPAs0ox63GRPioSZt%2Fuploads%2FVV0qvAA2Apua6nvVTLtn%2Fportal.png?alt=media&#x26;token=38b74933-f824-4e15-ba10-ec3a5270ddec" alt="The Pentaho training portal sign-in page"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## At a glance

<table><thead><tr><th width="200"></th><th></th></tr></thead><tbody><tr><td><i class="fa-layer-group" style="color:blue;">:layer-group:</i> <strong>Courses</strong></td><td>5 mandatory, in a set order — Business Analyst, then the four Analytics Developer courses: Schema Workbench, Metadata Editor, Report Designer and CTools — then the certification</td></tr><tr><td><i class="fa-sparkles">:sparkles:</i> <strong>Specialities</strong></td><td>5 optional, coming soon — Semantic Model Editor, Embedded Analytics, Analytics Performance, Multi-tenant Analytics and Preparing Data for Analytics</td></tr><tr><td><i class="fa-chalkboard-user">:chalkboard-user:</i> <strong>Format</strong></td><td>A mix of hands-on workshops and short reading pages, self-paced</td></tr><tr><td><i class="fa-clock" style="color:cyan;">:clock:</i> <strong>Time</strong></td><td>~6h 40m Business Analyst · ~43h 40m Analytics Developer</td></tr><tr><td><i class="fa-cloud" style="color:cyan;">:cloud:</i> <strong>Delivery</strong></td><td>On Pentaho's hosting platform — Lab Guide embedded in every lab</td></tr><tr><td><i class="fa-door-open">:door-open:</i> <strong>Entry requirements</strong></td><td>None beyond the path itself — it starts with Business Analyst. REPLACE-ME — confirm whether an existing Business Analyst credential is recognised in its place</td></tr><tr><td><i class="fa-tag" style="color:$primary;">:tag:</i> <strong>Built against</strong></td><td>Pentaho Enterprise Edition 11.0.0.0-232</td></tr><tr><td><i class="fa-globe" style="color:purple;">:globe:</i> <strong>Language</strong></td><td>English</td></tr><tr><td><i class="fa-award" style="color:orange;">:award:</i> <strong>Certification</strong></td><td>Certified Solution Analyst: all five mandatory courses plus a proctored exam delivered through Kryterion's Webassessor.</td></tr><tr><td><i class="fa-clock-rotate-left" style="color:cyan;">:clock-rotate-left:</i> <strong>Last updated</strong></td><td>REPLACE-ME</td></tr></tbody></table>

***

## Common questions

<details>

<summary>What order do I take the courses in?</summary>

The order of the path above: Business Analyst first, then the four Analytics Developer courses — Schema Workbench, Metadata Editor, Report Designer and CTools. The certification closes the path.

</details>

<details>

<summary>What does the proctored exam involve?</summary>

The certification exam is booked and sat through Kryterion's Webassessor platform, either online from your own computer under live proctoring or at a Kryterion-authorised test centre. Expect to install a secure browser in advance, show photo ID, pan your webcam around the room, and sit the exam with no notes or second screens. Rescheduling is free up to 72 hours before the slot; later changes can carry a fee.

</details>

<details>

<summary>Do I need my own Pentaho environment?</summary>

No. Every course runs in a hosted lab, with the Lab Guide embedded. There's nothing to download, install or configure.

</details>

<details>

<summary>What's in the Analytics Developer courses?</summary>

The Analytics Developer track underneath the User Console: Mondrian cubes in Schema Workbench, metadata domains in Metadata Editor, print-quality reports in Report Designer, and fully custom dashboards in CTools — four courses, each with its own labs and embedded exam. The Semantic Model Editor is one of five optional Speciality courses, coming soon.

</details>

<details>

<summary>I've already done the Business Analytics path — do I repeat those courses?</summary>

REPLACE-ME — confirm whether Business Analyst and the Analytics Developer courses completed on the Business Analytics path count towards this one.

</details>

<details>

<summary>Can my whole team take this path?</summary>

Yes. Your Account Executive can size the order for the team and have vouchers issued for each learner.

</details>

<details>

<summary>How long do I have access to the labs?</summary>

REPLACE-ME — confirm the access period a voucher grants, and what happens when it ends.

</details>

***

<h3 align="center">Still have questions?</h3>

{% columns %}
{% column %}
{% hint style="info" icon="gitbook-assistant" %}
**Quick answers about the content**

Which tools a course covers, what a model is, how this path differs from Business Analytics. Press <kbd>Ctrl</kbd> + <kbd>K</kbd> and click **Ask** for an instant answer from these pages.

<button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">Ask about this path...</button>
{% endhint %}
{% endcolumn %}

{% column %}
{% hint style="info" icon="envelope" %}
**Talk to the Academy team**

For anything the assistant can't answer — pricing, licensing, access periods, or sizing a programme for your team — email us at <academy@pentaho.com>.

We read every message and reply as soon as we can. If it's easier to talk it through, we'll set up a call from there.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

***

<p align="center"><a href="https://academy.pentaho.com/academy-landing-v2-sandbox/readme.md" class="button secondary" data-icon="arrow-left">Back to all learning paths</a></p>


---

# 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://academy.pentaho.com/solution-analyst-path-sandbox/solution-analyst.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.
