Tools reference · Agents
Edit a paper agent
edit_agent 50 credits a callChanges 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
Inputs
| Name | Description |
|---|---|
agent_id Required | id. The agent's id, as my_agents lists it. Your AI looks it up for you. |
rules Optional | object. New rules, exactly as build_rules returned them. |
description Optional | text. Instead of rules, the new strategy in your own words. |
name Optional | text. A new name. |
risk_usd Optional | positive number, up to 100,000. New dollars risked per trade, from 0.1% to 5% of the paper account. |
max_trades_per_day Optional | whole number, 1 to 5. The most trades it takes in a day, from 1 to 5. |
months Optional | one 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.”
{
"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.
Related
See all tools, example prompts and limits and credits.
Updated November 17, 2026. Education, not investment advice.