{"uid":"cap_KRL0c0lIQ5nduUgOboGg0","slug":"tradepilotusa-provider-shortlist-4892417c","name":"TradepilotUSA Provider Shortlist","description":"Rank the supplied providers using transparent criteria and missing-data handling; no external directory search is claimed. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.","url":"https://www.tradepilotusa.com/api/agent-commerce/v1/services/provider_shortlist/execute?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"brief":{"type":"string","maxLength":12000,"minLength":10},"audience":{"type":"string","maxLength":500},"source_text":{"type":"string","maxLength":32000,"minLength":20}}},"responseSchema":{"type":"json","example":{"task":"provider_shortlist","summary":"Vendor B ranks higher than Vendor A due to a broader scope including staff training, despite higher cost and implementation effort. However, critical data such as current booking volume, customer feed","artifact":"Illustrative excerpt from a synthetic provider check:\n## Provider Ranking for Example Door Company Scheduling Improvement Project\n\n### Evaluation Criteria\n1. **Implementation Effort**: Estimated workload and complexity to execute the vendor's proposal.\n2. **Scope Clarity**: How clearly defined and comprehensive the vendor's proposed services are.\n3. **Staff Training**: Inclusion and extent of training offered to staff.\n\n### Providers\n| Vendor | Proposal Description                        | Price | Implementation Effort | Scope Clarity | Staff Train","provenance":{"source":"buyer_supplied","generated_at":"2026-09-22T14:41:24.882Z","external_research_performed":false},"request_id":"example_provider_shortlist","assumptions":["Implementation effort is inferred from the complexity of proposed services.","Scope clarity is judged by the breadth of services described."],"evidence_gaps":["Details on the depth and deliverables of the process assessments.","Specific content and duration of the staff workshop."],"requires_human_review":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mPEaBVHlPLyrxJa8-avNU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes vendor proposals from supplied source text and returns a ranked shortlist of providers with evaluation criteria, evidence gaps, and assumptions.","exampleAgentPrompt":"I have proposals from three HVAC vendors for our office retrofit project — can you rank them based on scope clarity, implementation effort, and staff training, and flag any gaps in the information they've provided? Here's the project brief and the full proposal text from each vendor.","exampleUseCases":[{"title":"Choosing a software implementation partner","prompt":"We got proposals from four CRM implementation vendors. Can you read through all of them and rank them by scope clarity, implementation complexity, and training support? Here's the project brief and all four proposal documents."},{"title":"Selecting a cleaning services contractor","prompt":"I have bids from three commercial cleaning companies for our new office. Compare them and tell me which one offers the best value — flag anything missing from their proposals. Here's what we need and the three bid documents."},{"title":"Evaluating marketing agency pitches","prompt":"We asked five agencies to pitch for our Q4 campaign. Can you shortlist them based on their proposals? I'll paste the campaign brief and all five pitch decks as text — tell me who ranks highest and why, and note any evidence gaps."}],"resultDescription":"Returns a JSON object with a ranked provider comparison including a summary explanation of the ranking rationale, a detailed markdown artifact table scoring vendors across evaluation criteria, provenance metadata, a list of assumptions made during analysis, identified evidence gaps in the submitted proposals, and a flag indicating whether human review is recommended.","failureModes":["Source text too short (below 20 character minimum) returns validation error","Brief below minimum length (10 characters) rejected","Ambiguous or incomplete proposals may result in large evidence_gaps lists and requires_human_review=true","Missing vendor differentiation in proposals leads to inconclusive rankings","Malformed JSON body returns 400 error","Rate limiting or payment failure (x402) blocks execution"],"whenToPreferThis":"Use this endpoint when you have collected multiple vendor or supplier proposals as raw text and need a structured, criteria-based ranking with explicit evidence gaps and assumptions documented. It is best suited for procurement decisions, RFP evaluation, and supplier shortlisting workflows where a human reviewer will validate the output. Prefer this over manual comparison when proposals are lengthy, numerous, or need traceable reasoning.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:47:16.208Z","isFirstParty":false,"canonicalSlug":"tradepilotusa-provider-shortlist-4892417c"}