{"uid":"cap_pfky7q2f0thZB2sP_dx4l","slug":"should-i-ask-the-human-73dfa0db","name":"Should I Ask The Human?","description":"Decide whether an agent should ask the human or safely infer and continue","url":"https://agent-product-normalizer.vercel.app/api/v1/should-ask-human","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":["task"],"properties":{"task":{"type":"string","maxLength":10000,"description":"Task the agent is about to execute"},"known_context":{"type":"string","maxLength":15000,"description":"Relevant known context"},"proposed_assumption":{"type":"string","maxLength":4000,"description":"Assumption the agent wants to make"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mUBLbUHglV8U06bS9KaX1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decides whether an AI agent should pause and ask the human for clarification or safely infer and proceed autonomously","exampleAgentPrompt":"I'm about to send the order confirmation email to the customer, but I'm not 100% sure which shipping address to use — the one from their profile or the one they mentioned in chat. Should I ask them or just pick the profile address?","exampleUseCases":[{"title":"Agent pauses before irreversible action","prompt":"I'm about to delete the old project files to free up storage space — my assumption is that anything older than 90 days is safe to remove, and I know the user mentioned archiving last week. Should I go ahead or ask the user first?"},{"title":"Ambiguous user intent during checkout","prompt":"The user asked me to 'place the order' but didn't confirm which payment method to use — they have two on file. I'm thinking I should use the default card. Should I ask or just proceed with that assumption?"},{"title":"Uncertain email recipient selection","prompt":"I need to send a follow-up email but the task just says 'reply to the client' and there are three people from that company in the thread. My proposed assumption is to reply-all. Do I need to ask the human which recipient to pick, or is that safe to infer?"}],"resultDescription":"Returns a clear recommendation on whether the agent should ask the human for clarification or safely proceed with the proposed assumption, along with supporting reasoning that explains the decision based on the task context and any assumptions the agent wanted to make.","failureModes":["Missing required 'task' query parameter returns a validation error","Extremely long task descriptions exceeding 10,000 characters are rejected","Ambiguous or near-empty context may result in a conservative 'ask human' recommendation even when inference might be acceptable","Network or service availability issues on the Vercel deployment may return 5xx errors"],"whenToPreferThis":"Use this endpoint when building agentic pipelines that need to decide autonomously whether to interrupt the user or self-resolve ambiguity. It is particularly valuable before irreversible actions (sending messages, placing orders, deleting data) where a wrong assumption has real consequences. Prefer this over hardcoded thresholds or ad-hoc logic when the cost of unnecessary interruptions (user friction) and the cost of wrong inference (mistakes) both matter and need to be balanced dynamically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-20T12:52:22.344Z","isFirstParty":false}