Skip to main content
Agents is in private beta, so things may change. If you hit a problem, tell us via Support & feedback.
A Hercules Agent is an AI worker you set up once and then leave running. You write down what its job is, connect the apps it needs, and choose what starts it off. From then on it does the work without you being there. Hercules Agents are a separate product from the Hercules App Builder. The App Builder builds apps for you. Hercules Agents do work for you, over and over. Switch to Agents at the top of the Dashboard sidebar to see every Hercules Agent in your Organization.
The Agents console: the sidebar's Build, Monitor, and Improve groups beside an Agent's instructions and the test chat

​
What can a Hercules Agent do?

Anything you can describe in writing, using the apps you connect to it. For example:
  • Sort incoming support tickets and draft replies
  • Post a summary into a Slack channel every weekday morning
  • Answer your team’s questions in a GitHub pull request
  • React to something happening in another app, like a new Stripe payment

​
How is this different from the other AI in Hercules?

They do different jobs.
  • Hercules Agents run a job you set up, over and over, without you there. Something else starts them off: a schedule, another app, or a teammate messaging them in Slack
  • The Hercules App Builder Agent builds and edits your app while you chat with it, inside the App Builder
  • Chat answers your questions and works across your connected tools, one conversation at a time, while you’re there

​
What are the parts of a Hercules Agent?

  • Instructions: what the Agent should do, written in plain English
  • Integrations: the tools and apps it’s allowed to use
  • Triggers: what starts it off, like a schedule or an event in another app
  • Channels: where it talks to people, like Slack, GitHub, Linear, or Teams
  • Guardrails: rules it has to follow, checked while it works
  • Runs: one job from start to finish. Every run is recorded, so you can read back exactly what the Agent did

​
How do I get started?

1

Create an Agent

Start from scratch, from a template, or from a description. See Create an Agent.
2

Write its instructions

Tell it what to do, and add any files it needs to read.
3

Test it

Open the test chat from the bar above any Build page.
4

Publish it

Your edits are saved as a draft. Click Publish to make them live. See Versions.
5

Decide what starts it

Add a trigger or connect a channel, then watch what happens under History.

​
Additional FAQ

Open an Agent and its pages appear in the sidebar, grouped by what you’re doing:
  • Build: Instructions, Integrations, Triggers, Channels, Files & skills, Guardrails, More
  • Monitor: History, Analytics
  • Improve: Auto-improve, Issues, Evaluate
The test chat and the Save and Publish buttons follow you across every Build page and Guardrails, so a change and the conversation you’re testing it in stay side by side.
Yes. Agents belong to your Organization, so everyone in it can see, edit, and run them.
Agents use AI credits, the same credits as the rest of Hercules. Runs cost credits, and so do Auto-improve, scoring, and run summaries. See Costs and limits.
Agents is switched on one Organization at a time. If Agents is missing from your sidebar, contact hello@hercules.app.