Deploy Agent

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

agent

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

deployed_agent_id

Typed ID of the created Agent.

unique_name

Unique name of the Agent.

label

Display name of the Agent.

agent_url

Link that opens the Agent in Pricefx.

calculation_started

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 agent value is not a valid Agent definition

The 'agent' payload is not a valid agent definition. Pass back the 'agent' object from generate_agent_json unmodified. Details: …

Pricefx rejects the Agent, for example because you do not have permission

The error from Pricefx.

See Also