Upgrade Agents to a New Magpie Version
Background
Magpie is the construction reasoning engine behind Procore AI agents. Each agent runs on a Magpie version, and if it's a custom agent, you can change the version in the Model section of the agent's configuration. After you upgrade an agent to a newer Magpie version, you can switch it back if it doesn't perform as expected. Procore may retire older Magpie versions in the future and will give advance notice. Learn more about Magpie. To learn how to upgrade custom agents in the Datagrid standalone product, see upgrading agents in Datagrid.
Things to Consider
Prerequisites
A Procore account with the Digital Coworker Enterprise package.
A custom agent that runs on a version of Magpie that you want to change.
Permissions
Upgrade one agent: Permission to edit that agent's configuration.
Upgrade agents in bulk: Only Company Admins can upgrade all of a company's custom agents at once.
Which agents use Magpie 3.0
New agents you build use Magpie 3.0 by default, and agents Procore provides are upgraded automatically.
Existing custom agents you or your company built stay on Magpie 2.5 until you upgrade them. Procore recommends upgrading before a Magpie version is retired.
You no longer need to join a program in Procore Explore to use Magpie 3.0.
If your company or project joined the Magpie 3.0 open beta, the beta has ended. 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 changes when you upgrade an agent
In the Instructions section of the agent's configuration, one Instructions field replaces the System Instructions, Planning Strategy, and Custom Instructions fields.
If you upgrade all agents at once, you can't review each agent's combined instructions first or bulk-undo the upgrade. See more in the Steps below.
Instead of choosing an LLM for your agent, you choose a level of effort: Low, Medium, or High. Higher effort levels give more thorough answers but take longer and use more Procore Credits.
Steps
Upgrade your agents to a newer Magpie version, or switch an upgraded agent back. When switching from 2.5 to 3.0 two things will take place: The LLM Generation setting is replaced with Effort level, and three of the Instructions sub-fields are collapsed into one, as described below.
Upgrade one agent
Open the agent Configuration panel for the agent you want to modify.
To do this, click the more menu next to the agent's name in a chat thread, and then click Go to Configuration.
Click Model.
In the Agent Model list, click Magpie 3.0. The LLM Generation setting is replaced by an Effort setting.
Note: If the Agent Model is locked because the agent inherits its settings, you may need to click the Disinherit gear icon first.In the Effort list, click Low, Medium, or High. Higher levels give more thorough answers but may take longer and use more Procore Credits.
Click the back arrow, and then click Instructions.
Review the combined text that Procore AI is recommending for the Instructions field. Edit it if needed.
Procore AI labels each part with the field it came from, such as "From System Instructions."
Procore AI doesn't copy empty fields or the starter text that came with a new agent. It copies everything you wrote or edited.
Click Save Changes at the top of your configuration editing panel.
Upgrade all agents at once
This option is available to Company Admins only. The Magpie 3.0 Upgrade panel appears in the Company Admin tool only when your company has agents that haven't been upgraded.
You can't choose which agents to include. The upgrade covers all of your company's Magpie 2.5 agents, including private agents. Agents set to other models, such as Magpie 1.1 Flash, aren't changed. Procore AI copies each agent's instructions into the new Instructions field and sets each agent's level of effort automatically, so there is no review step. You can't undo the upgrade for all agents at once, but you can switch individual agents back to Magpie 2.5.
Go to the Company level Admin tool.
Under Company Settings on the right, click Procore AI.
On the General Access tab, find the Magpie 3.0 Upgrade panel. It shows how many agents will be upgraded from Magpie 2.5 to 3.0, how many are missing instructions and effort, and how many need no changes. Click the agent count to review the agents as needed.
Click Start Upgrade.
Review the Instructions field and the Effort setting of the agents, and test the workflows they support.
Switch an agent back to Magpie 2.5
Switching back to Magpie 2.5 reverts back to your original System Instructions, Planning Strategy, and Custom Instructions as they were before you upgraded. Changes you made in the Instructions field after upgrading to Magpie 3.0 aren't copied to the agent when you switch back to 2.5.