> For the complete documentation index, see [llms.txt](https://docs.pharos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pharos.ai/configuration-guide/org-genie-settings.md).

# Org Genie Settings

Enable and configure Org Genie in Pharos Admin by completing its setup checklist—OpenAI, GitHub, Change Tracking, Log Data Index, and CSP settings.

Org Genie brings AI-powered analysis into Pharos—ask questions in plain language and get answers grounded in your org's logs, issues, and metadata. At the org level, you can query trends and prioritize work; at the issue level, you get context-specific root cause suggestions and recommended actions.

The **Org Genie Settings** page is a setup checklist: each capability shows a checkmark when it's ready, or a **Setup Now** button when it still needs configuring.

{% hint style="info" %}
For Org Genie concepts and capabilities, see [Org Genie](https://docs.pharos.ai/platform-overview/pharos-platform-architecture/ai-analysis/org-genie.md).
{% endhint %}

***

## Accessing Org Genie Settings

Navigate to **Pharos App → Pharos Admin → Org Genie Settings**.

Before any setup, each capability shows a **Setup Now** button. Note that **Log Data Index** stays disabled with a *"Needs OpenAI integration"* message until OpenAI is connected—so set up OpenAI first.

![Org Genie Settings before setup — each capability shows Setup Now, and Log Data Index is disabled with "Needs OpenAI integration"](https://4264222071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdl9tmJ56lvwg5XY63QYr%2Fuploads%2Fgit-blob-281a98fc47991a829da0aaa066bbde492685fcc6%2Forg-genie-settings-setup.png?alt=media)

***

## The Setup Checklist

Complete these capabilities to enable Org Genie. Each is configured from this page and flips to a checkmark once ready.

| Capability             | What it enables                                                   | Requirement                                                                     |
| ---------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **OpenAI Integration** | The AI model that powers Org Genie's analysis and semantic search | **Required** — configure first; other steps depend on it                        |
| **CSP Settings**       | Sets up a Trusted Site for Org Genie's websocket connection       | **Required** — needed for the chat interface                                    |
| **Change Tracking**    | Lets Org Genie read your codebase and change history              | Optional, **recommended** — adds metadata analysis on top of observability data |
| **GitHub Integration** | Connects a repository so Org Genie can read metadata and code     | Optional — needed for Change Tracking                                           |
| **Log Data Index**     | Semantic search across logs and issues                            | Optional — requires OpenAI, so it stays disabled until OpenAI is connected      |

The two required pieces are **OpenAI** (the AI model) and **CSP Settings** (the chat interface's connection). The rest are optional, though enabling **Change Tracking** is recommended so Org Genie can reason over your metadata and change history alongside the observability data. OpenAI needs an API key — your own, or one Pharos provides on request; see the [OpenAI integration](https://docs.pharos.ai/configuration-guide/integrations/openai.md).

![Org Genie Settings after setup — OpenAI, GitHub, and Change Tracking show checkmarks; Log Data Index and CSP Settings offer Setup Now](https://4264222071-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdl9tmJ56lvwg5XY63QYr%2Fuploads%2Fgit-blob-6b104b834bda925966dee7f1cdf112df45e22361%2Forg-genie-settings-configured.png?alt=media)

{% hint style="success" %}
**Better analysis with Change Tracking:** When [Change Tracking](https://docs.pharos.ai/configuration-guide/change-tracking.md) is enabled, Org Genie can read metadata from GitHub instead of the org—reducing API usage and speeding responses.
{% endhint %}

***

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🧠 OpenAI Integration</strong></td><td>API key and model configuration</td><td><a href="https://docs.pharos.ai/configuration-guide/integrations/openai.md">OpenAI</a></td></tr><tr><td><strong>🔁 Change Tracking</strong></td><td>GitHub-backed metadata history</td><td><a href="https://docs.pharos.ai/configuration-guide/change-tracking.md">Change Tracking</a></td></tr><tr><td><strong>🧞 Org Genie Overview</strong></td><td>Concepts, org-level and issue-level analysis</td><td><a href="https://docs.pharos.ai/platform-overview/pharos-platform-architecture/ai-analysis/org-genie.md">Org Genie</a></td></tr></tbody></table>
