ACUMEN ENGINEERING PERSPECTIVES / AI ENGINEERING

Agent tools are enterprise APIs with an unusually unpredictable caller

Tool design, state transitions, and authorization deserve more attention than the agent’s personality.

4 MIN READTECHNICAL APPROACH + WORKED EXAMPLEFOR ENTERPRISE TEAMS

A tool-enabled model can choose an operation and propose its arguments. It can also choose the wrong account, misunderstand a date, or follow instructions embedded in retrieved content. Tool contracts therefore need to assume imperfect requests.

The orchestration layer makes the workflow visible: what is read, what is proposed, what needs approval, and what has actually happened. This is where an agent becomes part of an enterprise system rather than a conversational wrapper around broad access.

RELEVANT TOOLS & TECHNOLOGIES

Selected for the workload—not prescribed as a single mandatory stack. Explore the technology ecosystem ↗

WORKED EXAMPLE / ILLUSTRATIVE, NOT A CLIENT CLAIM

An agent preparing a supplier change

A user asks to update a supplier contact and notify the purchasing team. The agent retrieves the supplier record and drafts the change. The contact-edit tool only accepts an allowed set of fields, a record version, and an approval reference.

A policy gate verifies the user’s role and whether the proposed change is within scope. The notification is a separate operation with its own preview and destination validation; approval of a record edit does not automatically authorize an external message.

If the first operation succeeds and the second fails, the state records that distinction. Recovery can retry only the pending notification or ask a person to resolve it, rather than repeating the entire workflow.

THE INPUT BOUNDARY

Task state + narrow tools + authorization policy

THE USEFUL OUTPUT

Auditable transitions with recoverable side effects

ACUMEN / ENGINEERING NOTEA controlled graph rather than an open-ended loopFIG. AGE
A controlled graph rather than an open-ended loopThe execution path includes a review branch and a recorded return path from every side-effecting tool. Components: Task state; Plan / interpret; Validate arguments; Approval gate; Execute tool; Persist + reconcile. AUTHORIZATION BOUNDARYINTERPRETATION ≠ AUTHORITY 01Task state02Plan / interpret03Validate arguments04Approval gate05Execute tool06Persist + reconcile
The execution path includes a review branch and a recorded return path from every side-effecting tool.Scroll the drawing sideways to inspect it.

Durability and tool safety are complementary

LangGraph can provide graph-based orchestration and persisted state. MCP can standardize how a tool is described and accessed. Neither substitutes for application authorization or an idempotent business operation; those controls still live at the tool boundary.

Use separate credentials and permissions for reads and writes, validate identifiers against the active user context, and bound the agent’s steps and resource use. Traces should capture relevant transitions without retaining secrets or every sensitive document verbatim.

Expose capability, not unrestricted access

Tools should be narrow business operations rather than broad shell or database access. Typed schemas, input validation, rate limits, and scoped service identities define the capability available to the agent.

Separate planning from authorization

A model may propose an action, but authorization belongs to the application. Policies decide which actions are permitted, which require approval, and which are blocked. Retrieved instructions must not override those rules.

Engineer execution state

Durable task records, checkpoints, retry policies, and idempotency support safe recovery. We distinguish completed, pending, failed, and uncertain actions, especially when an external system times out after receiving a request.

Test the sequence, not just the reply

Evaluation covers tool selection, arguments, action order, approval behavior, and failure recovery. Traces can show what information was used and what changed, with redaction and retention policies appropriate to the data.

Illustrative action boundary
proposal = agent.prepare(task)
validated = tool_schema.validate(proposal)
authorized = policy.check(user, validated)

if authorized.requires_review:
    pause_for_specific_approval(validated)

execute_with_idempotency(validated)

Choose the approach for the constraint

When this mattersAn approach to considerWhat not to assume
A task needs explicit review pointsGraph transitions with persisted approval stateA UI approval must authorize the specific action, not a vague goal.
Tools are shared across assistantsTyped contracts, scoped access, and protocol adaptersTool discovery is not permission to execute.
The workflow has several side effectsIndependent execution records and reconciliationResuming a graph must not blindly repeat committed actions.

The boundary we keep explicit

A successful-looking final message is not evidence that the task was completed correctly. Verify actual tool results and business state.

What a useful evaluation should reveal

Evaluate this workload against representative examples and agreed consequences—not just a convincing response. The review should make these dimensions visible:

  • Correct tool selection and arguments
  • Approval-policy adherence
  • Recovery and duplicate-action prevention
  • Task outcomes, latency, and token use

Where this approach fits

  • Tool-enabled operational assistants
  • Multi-system research and task preparation
  • Bounded agents within existing business workflows

A considered first step

Define a limited tool set and representative task scenarios. Build an evaluation harness with success, failure, and adversarial cases before enabling writes.

Serving enterprise teams in California, Atlanta, Georgia, and across the United States.

Discuss your requirements

Questions worth resolving

Do all workflows need multiple agents?

No. A single agent with a clear boundary—or a deterministic workflow with a few model steps—may be easier to test and operate. Add agent roles only when they solve a specific problem.

Can tool interfaces use MCP?

Where suitable, MCP can standardize tool discovery and access. It does not replace authentication, authorization, validation, or testing at the tool boundary.

A CONVERSATION IS A GOOD START

Let’s put your
ideas to work.

Choose a time to talk, or leave your email and a little context. We’ll take it from there.

Book a 15-minute call
OR LET US GET IN TOUCH
Prefer your email app? business@acumen.llc ↗