The deploy_agent tool creates an Agent on your Pricefx partition from an Agent definition (JSON) and starts calculating it. The tool writes to your partition, so the AI assistant deploys an Agent only when you ask for it.
The deploy_agent tool only triggers the calculation. It does not report whether the calculation succeeds or fails.
Tool Name – deploy_agent
Title – Deploy Agent
Type – Private
Access Profile – Operator
Permissions
The deploy_agent tool uses your Pricefx permissions. You can deploy an Agent only if your Pricefx permissions allow you to create Agents. The tool is available to the Operator access profile, so every user on a private connection can use it. The tool is available only when the agent generator is set up on the MCP server.
Parameters
|
Parameter |
Required |
Description |
|---|---|---|
|
|
Yes |
Agent definition to create. Use the Agent definition that the Generate Agent JSON tool or the Update Agent JSON tool returns, without changes. |
Output
|
Field |
Description |
|---|---|
|
|
Typed ID of the created Agent. |
|
|
Unique name of the Agent. |
|
|
Display name of the Agent. |
|
|
Link that opens the Agent in Pricefx. |
|
|
true if the calculation of the Agent started. false if the Agent was created but its calculation did not start. In that case, start the calculation in Pricefx. |
Behavior and Limitations
-
The tool creates one Agent per call.
-
The tool calculates all steps of the Agent, from Data Scope to Summary.
-
The calculation runs in the background. The tool returns before the calculation finishes, so the Agent has no results yet.
-
The tool reports whether the calculation started, not whether it succeeded. To see the result of the calculation, open the Agent in Pricefx with the link in
agent_url. -
If the calculation cannot start, the Agent still exists. The tool does not delete it.
-
The tool deploys the Agent definition as given. To change the definition, use the Update Agent JSON tool before you deploy.
Errors
|
Situation |
Error Message |
|---|---|
|
The |
|
|
Pricefx rejects the Agent, for example because you do not have permission |
The error from Pricefx. |