> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aixy-gateway.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Advisor

> Find reliability, cost, context and tool improvements in your recorded model and tool usage.

**Observe → Advisor** reviews the model calls and MCP tool calls Aixy recorded for the selected
scope and period, and lists what deserves attention. Each recommendation shows the evidence it is
based on and a next step. Advisor never changes configuration on its own.

Advisor is a paid feature. It requires permission to read usage and Activity for all users:
Owners and Org admins have it for the organization, and Project admins for their projects.

## Read the recommendations

1. Open **Observe → Advisor**, choose a project or the organization, and choose a reporting
   period.
2. Filter by **Recommendation type** or **Recommendation status**.
3. Open a recommendation to see its **Summary**, **What this means**, **What we checked** and the
   **Recommended next step**.

| Type | What Advisor looks for |
| - | - |
| **Reliability** | A model whose recorded calls include a notable share of errors or incomplete observations. |
| **Cost** | Prompt caching whose estimated net input savings are negative, so cache writes cost more than reuse saves. |
| **Context** | Conversation history and tool definitions taking a large share of estimated input. |
| **Tools** | An MCP tool with repeated errors or unknown outcomes. |

Priority separates findings that **Need attention** from **Opportunities**. Recommendations are
evidence for an investigation, not a diagnosis: they do not identify a root cause or establish a
provider fault. Confirm the cause in [Activity](https://docs.aixy-gateway.com/observe/activity.md) before changing credentials,
routing, retries, caching or the model.

## Check the evidence

**Evidence coverage** states how many records were observed, the retained period, and whether a
source could not be reviewed or a group limit made the review partial. Your plan's analytics
retention limits the periods you can choose.

* Cost estimates use recorded usage and prices. They are not an invoice, and requests without
  comparable usage, prices or cache-write lifetime stay unmeasured.
* Context composition uses character-based token estimates and only complete observations. No
  prompt, response or tool content is inspected.
* An unknown tool outcome can include an action that completed externally. Check the external
  service before retrying it.

## Act on a recommendation

For a caching finding, **Review caching policy** shows the current policy of the provider
connection, checked separately from the historical evidence. A change applies to the connection
and all its eligible models, and requires an explicit apply action. See
[provider prompt caching](https://docs.aixy-gateway.com/guides/prompt-caching.md).

Choose **Ignore** to hide a recommendation, and **Restore** to bring it back. Read and ignored
status is personal to you. Findings remain until their evidence leaves the reporting period.

## When there are no recommendations

An empty list means no active recommendation meets the evidence thresholds in that scope and
period. It does not confirm that every request succeeded. If Advisor reports no recorded
activity, send traffic through Aixy or choose another period.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.