Skip to main content

Tool calling

A model on its own only writes text. An agent can also do things: open a file, search the repo, run tests, or call a connected app. That loop — decide an action, run it, read the result, continue — is tool calling. You describe the outcome; 4RGE handles the steps and shows you what happened.

What this page is for

You want to…This page helps you…
Understand "tools"Plain language — not API schemas
Know what agents can actually doCode, terminal, web, integrations — at a high level
See why prompts appearApprovals before risky or external actions
Use agents confidentlyHabits that match how tool loops behave
Go deeper in the productPointers to Tools and Agents
Part of 4RGED Learn

Read How AI models work first if models vs agents is new. Pair with Context — every tool result becomes part of what the model sees next.

Who this page is for

You are…Focus on
New to AI codingWhat tool calling means → What you see in chat
Daily developerWhen you approve + Habits that work
Team leadShare approval habits; point builders to Tools
AdminAgent security and org limits — this page is member-facing

What tool calling means

Tool calling is when the model asks the app to run a defined action instead of guessing from memory alone.

Without toolsWith tools
"Probably your tests live in __tests__…"Opens the repo, finds the test file, reads the failure
Invents a command that might not existRuns your test runner and uses real output
Stale docs from trainingFetches current docs or connected ticket data when allowed

You do not pick tools from a menu. You write the goal ("fix this failing test", "find where we validate JWTs"). The agent chooses steps. Many steps run on their own; sensitive ones wait for you — see When you approve.

Think of it like a skilled teammate with hands on the keyboard: they can look things up and run commands, but you still review anything that could break production or leak secrets.

What you see in chat

Tool calling is visible. As the agent works, you typically see:

In the threadWhy it matters
Which action ranSearch, read, edit, shell command, integration call
ResultsFile snippets, test output, search hits
Proposed editsDiffs you can accept or reject
Approval promptsPaused steps that need your OK

That transparency is the point — you are not trusting a black box. You follow the loop the same way you would watch a junior dev share their screen.

If output is huge (a long test log), the agent may summarize or narrow the next command. Very long tool output also fills context — another reason to scope tasks clearly.

Kinds of actions

4RGE groups agent capabilities into a few familiar areas. Exact names in the UI may vary; the ideas are what matter:

AreaWhat the agent might doExample ask
CodebaseFind, read, and edit project files"Fix the TypeScript error in the auth module"
TerminalRun builds, tests, linters, Git in your workspace"Run the unit tests for this package"
WebFetch public docs or check web behavior"Look up the latest API for this library"
IntegrationsCall connected apps your org enabled"Create a draft ticket with this summary"
Session helpersBreak work into steps or delegate a sub-task"Plan first, then implement in small commits"

Plugins and MCP connections add more integration tools your team installs — the agent uses them the same way, with the same approval rules.

For product detail (approvals, extensions, cloud behavior), see Tools.

When you approve

Not every tool call interrupts you. Routine reads and many safe edits often proceed so you can stay in flow. 4RGE pauses when an action crosses a trust boundary, for example:

Often needs your OKWhy
Destructive shell commandsDeletes, disk operations, force pushes
Network or external systemsPushes, unfamiliar integrations, credential paths
Sensitive readsFiles that may contain secrets
Large or ambiguous changesEdits outside the area you described

When a prompt appears:

  1. Read what was proposed — command, path, or integration
  2. Approve or deny — deny is fine; the agent can try a safer path
  3. Allow for session (optional) when you trust a repeat action, like your test suite
Treat approvals like code review

Skimming "approve all" on terminal commands is how accidents happen. If you would not run it yourself, deny and restate the constraint.

Org policy may further restrict models, networks, or integrations — Agent security.

Tools and context

Each tool call has two side effects worth remembering:

EffectPlain meaning
Context growsResults are added to what the model sees next — Context
Usage accumulatesMore steps usually mean more tokens — Tokens & pricing

A multi-step fix (search → read → edit → test → edit again) is normal. It is also why one clear task per run beats an open-ended "refactor everything."

Tool definitions themselves take a slice of context (the agent needs to know what actions exist). Teams with many plugins or MCP servers should expect a slightly heavier baseline — admins tune what is enabled.

Habits that work

  1. State the outcome — "make pnpm test pass in packages/auth" beats "fix tests."
  2. Say what is off limits — "inspect only, no edits" or "do not push."
  3. Name an integration when you need it — "use our issue tracker" if your org connected one.
  4. Review diffs and commands — tools make mistakes; you are the final gate.
  5. Split huge work — planning in one run, implementation in the next keeps tool loops focused.
  6. Run verification yourself when stakes are high — CI green beats the agent saying "should work."

When something fails repeatedly, check whether the agent lacks real output (tests not run, wrong directory) before switching models.

Where to go next

Your goalNext step
Product guide to tools & approvalsTools
Agent loop & surfacesAgents
What fills the windowContext
Connect external systemsMCP · Plugins
Trust & policyAgent security
Try itQuickstart

Questions about tool calling?

QuestionAnswer
Do I choose tools manually?No — describe the goal; the agent picks steps.
Can the agent run any shell command?Only in your workspace, with approvals for risky commands — Tools.
What is MCP?A standard way to plug external apps into agents — MCP.
Why so many steps for one fix?Agents verify with reads and tests; each step is a tool call.
Do tools cost extra?They consume tokens like any other context — Tokens & pricing.
Where is the full tool list?Tools — Learn stays conceptual; product docs stay detailed.