{"uid":"cap_usMqvA1ox7KndP9hg-KC0","slug":"agent-next-step-selector-9ee13cc3","name":"Agent Next Step Selector","description":"Rank candidate next actions against the current agent state","url":"https://agent-product-normalizer.vercel.app/api/v1/choose-next-step","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":["state","actions"],"properties":{"state":{"type":"string","maxLength":12000,"description":"Current agent state"},"actions":{"type":"string","maxLength":12000,"description":"Candidate actions separated by | or newlines"}},"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.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0upte4qg_nRRSIRt3j-3z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks a list of candidate next actions against the current agent state to recommend the best next step","exampleAgentPrompt":"I have an agent that just finished gathering user requirements and now needs to decide what to do next — here are its current state and three candidate actions separated by pipes: rank them so I know which one to execute first.","exampleUseCases":[{"title":"Multi-step research agent planning","prompt":"My research agent has gathered 5 sources and partially summarized two of them. It has these four possible next actions: 'summarize remaining sources | cross-reference findings | generate report draft | ask user for clarification'. Which one should it do next given that state?"},{"title":"Customer support bot next action","prompt":"My support bot just confirmed the user's account is active and identified a billing discrepancy. Candidate next steps are: 'escalate to billing team | issue automatic refund | ask user for invoice number | send FAQ link'. Rank these against the current state and tell me the best next step."},{"title":"Autonomous shopping agent step selection","prompt":"My shopping agent has compared three product listings and found the cheapest option. Now it needs to choose from: 'add to cart | check return policy | verify seller rating | notify user'. What should it do next given where it is in the workflow?"}],"resultDescription":"Returns a ranked list of the candidate actions with the recommended best next step highlighted, scored or ordered by appropriateness relative to the provided agent state. Likely includes the top recommended action and a rationale or confidence ordering for the remaining candidates.","failureModes":["Missing required 'state' or 'actions' query parameters returns a validation error","State or actions string exceeds 12000 character limit causing a 400 error","Ambiguous or poorly formatted actions list (not separated by | or newlines) may produce unreliable rankings","Empty actions list returns an error or empty ranking","Service unavailability returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when an autonomous agent has a concrete list of candidate next actions and needs a lightweight, fast decision on which to execute given its current operational state. It is ideal for multi-step agent pipelines where the orchestrator must pick the next tool call without burning tokens on a full LLM reasoning pass. Prefer this over general-purpose LLM prompting when you want a consistent, cost-effective ranking signal specifically tuned for agent state-action matching.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:47:36.470Z","isFirstParty":false}