What is Magpie in Procore AI?

Background

When you ask our AI a question or give an agent a task, our reasoning engine decides how to get the work done. This reasoning engine is called Magpie. Each agent's Magpie version is set in the Agent Model setting of its configuration.

Answer

Magpie is the construction reasoning engine behind Procore AI and Datagrid's AI. It plans how to handle a request, calls the agents, actions, and skills it needs, checks the results, and recovers when a step fails. Magpie isn't the large language model (LLM) itself. It directs how the AI and its agents use an LLM to complete your request.

Current version

Magpie 3.0 is the current version, as of November 19, 2026.


What's unique about Magpie 3.0

Complexity: Magpie 2.5 wrote a plan and followed it. Magpie 3.0 is designed to work more like an experienced project engineer, checking data availability, writing and running its own queries, opening several records at once, and continuing until all parts of the question are answered. For example: Magpie 3.0 can open several RFIs at once, split a long spec into sections and review in parallel, and then combine what it finds. When a task can't be completed, Magpie 3.0 is designed to stop and tell you.

Speed: Magpie 3.0 is faster at answering some types of questions, but it's also designed to keep working until every part of a question is answered. That means it sometimes looks beyond the first record that only seems to answer the question. For example: When two drawing sheets have the same title and the drawing log lists both as current, Magpie 3.0 can check title blocks and other records to avoid serving up a stale sheet. If you'd like your agent to run more quickly, set it's Effort level to 'Low' or 'Medium', as described below.

Magpie 3.0 changes how agents are set up:

  • One Instructions field replaces the System Instructions, Planning Strategy, and Custom Instructions fields.

  • Instead of choosing an LLM, you choose a level of effort: Low, Medium, or High. Higher effort levels give more thorough answers but may take longer and use more credits. 

What changes at general availability

  • Automatic upgrades:

    • New agents you create use Magpie 3.0 automatically.

    • Procore accounts: Agents that Procore provides with your Digital Coworker package, including the AI's auto mode, are upgraded to Magpie 3.0 automatically. 

  • Manual updates: Existing agents you or your company built stay on Magpie 2.5 until you upgrade them individually or in bulk. Learn how in Procore AI or Datagrid.

  • Beta program for Procore AI: The Magpie 3.0 beta program is over, and joining in Procore Explore is no longer needed to use Magpie 3.0. For any accounts that were in that program, agents that ran on Magpie 3.0 during the beta go back to Magpie 2.5 until you upgrade them. The beta never changed your agents' settings.

What to do next

Upgrade the custom agents your company built, before Magpie 2.5 is retired.

  • How to upgrade. You can upgrade one agent at a time, with a step to review its combined instructions. A Company Admin (in Procore) or an organization Owner or Admin (in Datagrid) can also upgrade all of the company's custom agents at once, though without a review step. Learn more about upgrading agents in Procore AI or Datagrid.

  • Review:

    • After upgrading each agent, review the proposed combined instructions before you save. After upgrading all agents at once, spot-check your most important agents.

    • Check each upgraded agent's level of effort (Low, Medium, or High). Higher levels give more thorough answers but may take longer and use more credits.

    • Test the workflows your team relies on most.

    • If an upgraded agent doesn't perform as expected, switch it back to Magpie 2.5 and let your Procore or Datagrid point of contact know.

Switch an agent back to Magpie 2.5

You can switch an upgraded agent back to Magpie 2.5, until that version is retired. The agent's original System Instructions, Planning Strategy, and Custom Instructions are kept, and Magpie 2.5 uses them as they were before you upgraded. Changes you make in the new Instructions field don't carry back to Magpie 2.5. Copy any changes you want to keep before you switch back.

See Also

Loading related articles...