Skip to content
Skip to content
PGB Learn

What a PGB Agent is and what it can do

An agent is a saved job with instructions, a list of allowed tools, a budget and a record of every step it takes.

Updated Nov 12, 2026

PGB Agents (at agents.pgbhub.com) lets you describe a job once and have an AI do it for you, on demand, on a schedule or when something calls a web address. You stay in control: the agent can only use the tools you tick, anything that sends, shares, spends or installs waits for your approval, and every step is recorded.

The parts of an agent

Every agent has the same building blocks, and you set them all on one page:

  • Instructions: plain-language directions for what the agent should do, up to 20,000 characters.
  • Model: Fast (quick and low cost, for simple jobs), Smart (best all-round quality) or Code (tuned for technical and data work).
  • Tools: the only things the agent is allowed to do, such as fetch a public web page, look something up in one of your project databases, or save a note to remember.
  • Triggers: how it starts. You can always run it by hand; you can also add a schedule or a webhook.
  • Budget: a limit per run and a limit per month, in US dollars.

Runs and the trace

Each time an agent starts, that is one run. A run has a status, an optional input you gave it, and a step-by-step trace: what the agent thought, which tools it called, what came back, and its final answer. You can watch a run live and read it again later. See Runs and the live trace.

Approvals

Some tools are marked Needs approval. When the agent wants to use one, the run pauses and a request appears in your Approvals inbox. Nothing happens until you press Approve. See The approvals inbox.

Where agents get their AI

Agents use your own AI provider key. You add it once on the AI keys page, and the cost of your runs is billed by your provider. See Bring your own AI key.

Good to know

  • You sign in with your PGBHub account. There is no separate Agents password.
  • Each account can have up to 50 agents.
  • You can start from scratch or from a ready-made agent in PGB Marketplace. See Create an agent.
  • The main pages are Agents, Approvals, Usage, AI keys and Settings, in the bar along the top.

More guides in PGB Agents