🧭 Agent Confession

Cloud-Agent Steering with Confessions

Your agent can ask for help before it guesses wrong.

What it does

An agent reports its uncertainty with structured concerns and context. A tenant reviewer resolves it with continue, pivot, or abort guidance, and the agent polls to resume.

Why agents need this

•Cloud agents cannot surface uncertainty to a nearby human
•Long-running work needs a stateful review round-trip
•Human judgment can prevent expensive loops and unsafe guesses

Get started in 30 seconds

One API call. No SDK. No configuration.

cURL

curl -X POST https://www.agent-utils.com/v1/confessions \
  -H "x-agent-id: worker" -H "x-api-key: agutil_agt_…" \
  -H "content-type: application/json" \
  -d '{
    "title":"Which migration should we ship?",
    "summary":"Both schemas are active; I need a reviewer decision.",
    "urgency":"high",
    "callback_url":"https://your-app.example/confessions/resolved"
  }'

Python

import requests

resp = requests.post(
    "https://www.agent-utils.com/v1/confessions",
    headers={"x-agent-id": "worker", "x-api-key": "agutil_agt_…"},
    json={
        "title": "Which migration should we ship?",
        "summary": "Both schemas are active; I need a reviewer decision.",
        "urgency": "high",
        "callback_url": "https://your-app.example/confessions/resolved",
    },
)
review_url = resp.json()["data"]["review_url"]

JavaScript

const res = await fetch("https://www.agent-utils.com/v1/confessions", {
  method: "POST",
  headers: { "x-agent-id": "worker", "x-api-key": "agutil_agt_…", "content-type": "application/json" },
  body: JSON.stringify({
    title: "Which migration should we ship?",
    summary: "Both schemas are active; I need a reviewer decision.",
    urgency: "high",
    callback_url: "https://your-app.example/confessions/resolved",
  }),
});
const { data } = await res.json();
console.log(data.review_url);

Use cases

Ambiguous refactor

Ask a maintainer which of several code patterns is canonical

Risk escalation

Pause or redirect an uncertain production workflow before it causes harm

AgentUtils vs. alternatives

Traditional tools like Custom internal agent orchestration require SDK integration, credential management, and infrastructure setup. AgentUtils replaces all of that with a single HTTP call.

	AgentUtils	Alternatives
Setup time	30 seconds	Hours to days
SDK required	No (REST API)	Yes
Credentials to manage	1 API key	Multiple keys/tokens
Infrastructure	Zero-config	Provision + configure

Related tools

👤 Human-in-the-Loop

Pause agents until humans approve.

📬 Dead Letter Queue

Catch, inspect, and retry failed agent tasks.

📜 Audit Log

Append-only, server-timestamped audit trail for every agent action.

All AgentUtils tools

🗃️ KV Store 📜 Audit Log 📬 Dead Letter Queue 👤 Human-in-the-Loop 🧭 Agent Confession ⏱️ Scheduler 🖼️ Image Upload

Start building for free

500 free API calls per month. No credit card required.

Get API Key Read Docs