# Agent Task Clarifier

> Agent Task Clarifier is a paid API for AI agents from agent-product-normalizer.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-18).

Transforms a messy, ambiguous human request into a structured, execution-ready goal with constraints, ambiguity signals, and at most one clarifying question

## Facts

- Endpoint: GET https://agent-product-normalizer.vercel.app/api/v1/clarify
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-task-clarifier-bd32421b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QH1sgmgXDpq4QSteEOseN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-task-clarifier-bd32421b
```

Example prompt: Take this messy request from the user and turn it into a clear, execution-ready goal with constraints and any ambiguity signals — and if something critical is still unclear, give me just one question to ask them: 'I want to get some stuff done this week, maybe write a blog post or two and email a few people, budget is kinda tight, nothing too formal'

## When to prefer this

Choose this endpoint at the start of an agent pipeline when the user's original request is vague, multi-part, or potentially ambiguous and you need a clean, structured goal before taking action. It is especially valuable when you want to avoid costly downstream mistakes caused by misinterpreting intent, or when you need to identify whether to ask the user exactly one targeted follow-up question rather than proceeding blindly. Prefer it over prompt engineering or in-context parsing when you want a reliable, token-efficient, structured output with explicit ambiguity signaling.

## Known failure modes

- Missing required 'text' query parameter returns an error
- Input text exceeding 20,000 characters may be rejected or truncated
- Highly structured or already-clear inputs may return minimal ambiguity signals with no clarifying question
- Network or server errors from the Vercel deployment may return 5xx responses
- Payment failure via x402 protocol results in 402 response before processing begins

## How this service works

Turn a messy human request into an execution-ready goal, constraints, ambiguity signals and one question only if needed

## Output

A structured object containing: a concise execution-ready goal statement, identified hard constraints and soft preferences, ambiguity signals indicating what information is uncertain or missing, and optionally one targeted clarifying question to ask the user if a critical unknown remains. This output is designed to be fed directly into an agent planning or execution pipeline.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "text"
     ],
     "properties": {
      "text": {
       "type": "string",
       "maxLength": 20000,
       "description": "Messy human task or request"
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-task-clarifier-bd32421b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-product-normalizer.vercel.app](https://www.zero.xyz/host/agent-product-normalizer.vercel.app/llms.txt)