# Huginn, the AI analyst

Huginn, the AI analyst, lives under **Understand > Huginn**. It picks its own read-only tools, runs them against the game you have selected, and answers with the numbers it used. A completed question is one shared AI unit, including every tool call it made on the way.

## The tools it reaches for

`get_overview`, `query_players`, `query_levels`, `get_retention`, `get_history`, `get_metrics`, `get_monetization`, `get_ad_revenue`, `get_campaigns`, `get_ltv_forecast`, `get_progression`, `get_economy`, `get_health`, `get_distribution`, `get_level_map`, `get_retention_split`, `get_data_quality`, `explain_metric_change`, `list_builds`, `compare_builds`, `get_funnel`, `get_property_breakdown` and `search_feedback` cover the numbers, what players spent and what players wrote. `get_code_brief` reads the source scan's notes, `list_playtest_jobs`, `list_playtest_findings`, `get_playtest_report` and `get_validation_report` read playtests, `list_feature_specs`, `get_feature_spec` and `get_feature_job` read [Build a feature](https://ravensight.io/docs/playtest/#labs-feature), `list_game_plans` and `get_game_plan` read [Create a game](https://ravensight.io/docs/playtest/#labs-create), and `list_touchpoints` and `get_sales` read marketing memory and the sales ledger, and the `list_pulse_*`, `get_pulse_post` and `search_pulse_comments` tools read [Pulse](https://ravensight.io/docs/pulse/). Huginn can call `describe_studio_data` to check what data the studio holds (see [Studio data](https://ravensight.io/docs/studio-data/)) before it chooses a tool. On deployments with journey graphs, `get_journeys`, `find_bottlenecks` and `get_top_paths` read those. When nothing else answers, it writes SQL with [run_sql](https://ravensight.io/docs/run-sql/). Every tool is read-only, and the game it reads is the one you selected, never an argument the model can change.

## Analyst context you write yourself

Findings are extracted by a model. Analyst context is the opposite: it is what you write, and the analyst is told to trust it over its own reading of the data. There are two levels, both inserted into the prompt verbatim and ahead of the findings. Game context lives in **Settings > Huginn** and holds up to 2,000 characters of facts about one game. Studio notes hold up to 1,000 characters of facts that are true across every game in the studio. A note like "levels 5 through 7 are an intentional difficulty spike" or "we ship weekly builds on Fridays" heads off a wrong conclusion before the analyst reaches for a tool. Writing either needs a member role or above; reading them needs nothing extra.

## The same question across every game

Four questions can be asked of the whole studio rather than one game: the headline metrics, what players spent, a funnel, and an event property's breakdown. The analyst has them as `compare_metrics`, `compare_monetization`, `compare_funnel` and `compare_property`, and the API exposes them under `/api/v1/studio/analytics/...`. This is how a problem in one game is told apart from a habit of the studio: if the tutorial loses the same share of players in all three of your games, the tutorial design is the finding. Studio totals are sums and conversions are weighted by volume. There is deliberately no studio median, because the median of medians is not the median. Studio revenue is summed per currency and never across two, and there is no studio revenue per paying player.

A studio answer covers at most 12 games. When more were eligible the response says so rather than presenting twelve games as the studio: `studio.truncated` is true and `studio.omittedGames` counts the games left out. A property breakdown also carries `studio.other`, the count of events whose value is not in the merged top list.

Source: https://ravensight.io/docs/analyst/
Last updated: 2026-11-15
