{"uid":"cap_QH1sgmgXDpq4QSteEOseN","slug":"agent-task-clarifier-bd32421b","name":"Agent Task Clarifier","description":"Turn a messy human request into an execution-ready goal, constraints, ambiguity signals and one question only if needed","url":"https://agent-product-normalizer.vercel.app/api/v1/clarify","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZwhRA6axci0VGmgJN1mS_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Transforms a messy, ambiguous human request into a structured, execution-ready goal with constraints, ambiguity signals, and at most one clarifying question","exampleAgentPrompt":"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'","exampleUseCases":[{"title":"Clarifying a vague automation request","prompt":"Before I kick off this workflow, clarify this user message into a structured goal with constraints and flag anything ambiguous: 'set something up so I get notified when important stuff happens with my accounts, not too spammy though'"},{"title":"Structuring a multi-step research task","prompt":"I need to clarify what this user actually wants before I start researching — can you parse this into an execution-ready goal and tell me if there's one key thing I should ask them first: 'look into what's going on with renewable energy, especially solar, maybe write something up, I dunno, something useful for investors'"},{"title":"Disambiguating a customer support request","prompt":"Turn this customer message into a structured task I can act on, pull out any hard constraints or exclusions, and give me one clarifying question if something critical is still ambiguous: 'I want to fix my plan, it's too expensive and I keep running out of data, especially when traveling, please sort it out'"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:47:58.905Z","isFirstParty":false}