{"uid":"cap_dbRqJ2lrn5yOPzYK8FVL8","slug":"tradepilotusa-kpi-definition-engine-fb486892","name":"TradepilotUSA KPI Definition Engine","description":"Define metrics with purpose, formula, source requirements, cadence, ownership, and interpretation limits. 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/kpi_definition/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":"kpi_definition","summary":"Defined five metrics for improving scheduling in a residential door installation business: booking volume, consultation completion rate, staff training effectiveness, process assessment findings, and ","artifact":"Illustrative excerpt from a synthetic provider check:\n## Metrics Definition for Scheduling Improvement Project\n\n### 1. Booking Volume\n- **Purpose:** Measure the number of door installation consultations booked to assess demand and scheduling load.\n- **Formula:** Count of consultations booked per week.\n- **Source Requirements:** Appointment booking system or manual logs capturing date and time of each consultation.\n- **Cadence:** Weekly.\n- **Ownership:** Scheduling coordinator or operations manager.\n- **Interpretation Limits:** Does not indicate con","provenance":{"source":"buyer_supplied","generated_at":"2026-09-22T14:42:09.958Z","external_research_performed":false},"request_id":"example_kpi_definition","assumptions":["The company uses some form of appointment booking system or manual logs.","Staff workshops and vendor assessments are part of the improvement project."],"evidence_gaps":["Actual booking volume and consultation completion data.","Customer feedback survey results."],"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_KIrV9r5tsz80L8qAlLbqW","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":"Generates structured KPI definitions and metrics frameworks from a business brief and source text, tailored to a specified audience.","exampleAgentPrompt":"Can you define KPIs for my residential door installation business's scheduling improvement project? The audience is our operations managers, and here's the brief: we want to reduce booking gaps and improve consultation completion rates — use that as the source text.","exampleUseCases":[{"title":"Scheduling improvement metrics for trades business","prompt":"I'm running a scheduling improvement initiative at my HVAC company and need formal KPI definitions. My audience is the ops team. Here's the project brief: we want to cut missed appointments by 30% and improve technician utilization. Can you generate a structured metrics framework from that?"},{"title":"Customer onboarding performance tracking","prompt":"We're launching a new customer onboarding process at my landscaping business and need to define success metrics. Audience is my department leads. Brief: we want faster time-to-first-service and higher client satisfaction in the first 90 days. Please define the KPIs we should track."},{"title":"Sales pipeline KPI framework from strategy doc","prompt":"I have a strategy document for improving our sales pipeline and need to turn it into concrete KPI definitions. The audience is our sales managers. Can you read through this source text and define the key metrics, formulas, measurement cadence, and who should own each one?"}],"resultDescription":"Returns a structured JSON response containing a task label, a plain-English summary of the defined metrics, a detailed artifact (markdown-formatted KPI definitions with purpose, formula, data source requirements, cadence, and ownership), a list of assumptions made, identified evidence gaps, a provenance record, a unique request ID, and a flag indicating whether human review is recommended.","failureModes":["Brief or source_text below minimum length (10 and 20 characters respectively) returns a validation error","Source text exceeding 32,000 characters is rejected","Ambiguous or overly vague briefs may produce generic or low-utility KPI definitions","External research is not performed, so gaps in input data lead to evidence_gap flags rather than filled metrics","Response may require human review when assumptions are significant"],"whenToPreferThis":"Choose this endpoint when you need to convert an unstructured business brief or project description into a formal, structured KPI framework with defined formulas, ownership, and cadence — especially for small-to-midsize trade or service businesses. Prefer it over generic LLM prompting when you need a consistent, structured JSON artifact with explicit evidence gaps and assumptions documented. Best for operational improvement projects, not real-time dashboard querying or financial reporting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:45:54.348Z","isFirstParty":false,"canonicalSlug":"tradepilotusa-kpi-definition-engine-fb486892"}