AI Agents
Using an agent
What an agent can do with SimpliGen, and how to keep it in bounds.
Once connected, just ask your agent in plain language. For example: "List SimpliGen's image presets, then generate a red fox in the snow and show me the file."
What an agent can do
- See what is available: every preset it can generate with, image or video, and whether the models are installed locally.
- Generate: start an image or video job from a prompt, with optional reference images or a start image. It can run locally, on SimpliGen Cloud, or pick automatically.
- Track jobs: check status and wait for a result.
- Hand back results: return the finished file path, or show the image right in the chat.
- Prepare presets: start downloading a local preset's models so it becomes ready to use.
Local vs cloud
Generations run locally by default and never cost credits. Cloud is offered only when you have SimpliGen Cloud connected, and a well-behaved agent asks before spending credits (or follows whatever auto-approve mode you run it in).
Keeping an agent in bounds
- Spend cap. When you connect an agent you can set an optional cloud spend cap. The agent can never spend more than that on cloud credits, no matter what it is asked to do. Local generation is always allowed and never counts against it. Leave the cap empty for no limit, or set it to 0 to block cloud entirely (local-only).
- Tokens are local and revocable. A pairing token only works against SimpliGen on your own machine, and you can revoke it any time from Connected agents. Revoking is instant.
- The app stays in control. The agent talks to SimpliGen; it cannot reach your cloud account or your key directly.
Run a few small ones first
Before handing an agent a big batch, try a couple of single local generations so you can see how it phrases requests and what it returns.
If your agent runs on a different machine, see Remote access.