Tools reference · Agents

Edit a paper agent

Action edit_agent 50 credits a call

Changes one of your rule agents: its rules, risk per trade, most trades a day or name. New rules are backtested first, and the change is saved as a new version.

What it does

Paper history stays with the old version. New rules are saved only if their backtest covers at least 3 months and 10 trades, and saving new rules closes a trade that is open.

Only rule agents are changed here. An agent that trades live is edited only in Senntric.

This tool makes a change

It changes something in your Senntric account. It needs the “Make changes” permission when you connect, and your AI app asks you to confirm before it runs. It can’t place an order at your broker.

Inputs

agent_id Requiredid. The agent's id, as my_agents lists it. Your AI looks it up for you.
rules Optionalobject. New rules, exactly as build_rules returned them.
description Optionaltext. Instead of rules, the new strategy in your own words.
name Optionaltext. A new name.
risk_usd Optionalpositive number, up to 100,000. New dollars risked per trade, from 0.1% to 5% of the paper account.
max_trades_per_day Optionalwhole number, 1 to 5. The most trades it takes in a day, from 1 to 5.
months Optionalone of 3, 6, 12, 24. How much history the backtest of new rules covers: 3 (the default), 6, 12 or 24 months.

Example

You ask

“Lower my QQQ agent's risk to $50 a trade.”

Result (trimmed, example values)
{
  "edited": true,
  "agent": {
    "id": "f3a9c2d1-6b7e-4a58-9c0d-2e4f6a8b1c3d",
    "name": "QQQ 5m agent",
    "kind": "rules",
    "symbol": "QQQ",
    "status": "running",
    "version": 2,
    "trades": "paper",
    "paper_account_usd": 10000,
    "risk_per_trade_usd": 50,
    "max_trades_per_day": 1
  },
  "note": "Saved as version 2; paper history stays with version 1."
}

Your AI reads this result and answers in plain words. Most results include an open_in_senntric link to see the same thing in Senntric.

See all tools, example prompts and limits and credits.

Updated November 17, 2026. Education, not investment advice.