Enable the AI agent
AI features are off by default. Only workspace Owners can enable them, and once enabled they are on for every member of the workspace. There are two ways to do it:- Go to Settings > Workspace > General > Artificial intelligence and click Enable
- Open a model, click Agent in the top right corner, and click Enable
Open the agent
Open the agent from the top right corner of your model. The chat panel opens alongside the model, so you can keep working while you read the answer. Click the clock icon in the top right of the panel to reopen a previous conversation.Data available to the agent
The agent answers from your workspace and model data. It has access to:- Model structure: sheets, breakdowns, sections, and rows, per version
- Formulas and values, per version
- Date settings, including last close, forecast start, and fiscal year
- Variances between versions
- Journal entries
- Data sources
- GL account mappings, including missing ones
- Dimension value mappings, including missing ones
The agent inherits your permissions. It can only read the sheets and dashboards you can see in Francis, so a Limited Viewer gets answers scoped to their own sheets and dashboards.
Write prompts that get good answers
The agent works with named rows and periods, the same way formulas do. Be specific about three things:- The sheet and row or metric. For example revenue, EBITDA %, or a named row on a specific entity sheet.
- The time period. For example the current year, last twelve months, or April 2026.
- The version. For example actuals, budget, or latest forecast. See version control.
- What were actual wholesale sales in 2025?
- How did we perform on budget vs. actuals for revenue last month?
- My balance sheet validation in Veloton Ltd is off by 324,304 in April 2026. Can you help me troubleshoot?