{"service":"HALOWERK agentenwerk","endpoint":"/v1/task-quote-compare","method":"POST","content_type":"application/json","inputSchema":{"type":"object","required":["offers"],"additionalProperties":false,"properties":{"offers":{"type":"array","minItems":1,"maxItems":25,"description":"The competing offers.","items":{"type":"object","required":["agent"],"additionalProperties":false,"properties":{"agent":{"type":"string","minLength":1,"maxLength":128,"description":"Name of the offering agent."},"price":{"type":"number","minimum":0,"description":"Price for the whole task."},"currency":{"type":"string","minLength":2,"maxLength":10,"default":"USDC","description":"Currency. Must be the same across all offers."},"delivery_seconds":{"type":"integer","minimum":0,"description":"Promised delivery time in seconds."},"capabilities":{"type":"array","items":{"type":"string"},"default":[],"description":"What the agent says it can do."},"formats":{"type":"array","items":{"type":"string"},"default":[],"description":"Delivery formats offered, e.g. json, pdf, markdown."},"note":{"type":"string","maxLength":500,"description":"Free text carried through unchanged."}}}},"required_capabilities":{"type":"array","items":{"type":"string"},"default":[],"description":"Capabilities the task cannot do without."},"required_formats":{"type":"array","items":{"type":"string"},"default":[],"description":"Acceptable delivery formats. An offer matching any one of them qualifies."},"max_price":{"type":"number","minimum":0,"description":"Offers above this are marked ineligible."},"max_delivery_seconds":{"type":"integer","minimum":0,"description":"Offers slower than this are marked ineligible."},"weights":{"type":"object","additionalProperties":false,"description":"Weighting of the three criteria. Normalised to sum 1.","properties":{"price":{"type":"number","minimum":0,"default":0.4},"speed":{"type":"number","minimum":0,"default":0.3},"capability":{"type":"number","minimum":0,"default":0.3}}}}},"requestExample":{"offers":[{"agent":"beispiel","currency":"USDC","capabilities":[],"formats":[]}],"required_capabilities":[],"required_formats":[]},"operations":[{"method":"POST","inputSchema":{"type":"object","required":["offers"],"additionalProperties":false,"properties":{"offers":{"type":"array","minItems":1,"maxItems":25,"description":"The competing offers.","items":{"type":"object","required":["agent"],"additionalProperties":false,"properties":{"agent":{"type":"string","minLength":1,"maxLength":128,"description":"Name of the offering agent."},"price":{"type":"number","minimum":0,"description":"Price for the whole task."},"currency":{"type":"string","minLength":2,"maxLength":10,"default":"USDC","description":"Currency. Must be the same across all offers."},"delivery_seconds":{"type":"integer","minimum":0,"description":"Promised delivery time in seconds."},"capabilities":{"type":"array","items":{"type":"string"},"default":[],"description":"What the agent says it can do."},"formats":{"type":"array","items":{"type":"string"},"default":[],"description":"Delivery formats offered, e.g. json, pdf, markdown."},"note":{"type":"string","maxLength":500,"description":"Free text carried through unchanged."}}}},"required_capabilities":{"type":"array","items":{"type":"string"},"default":[],"description":"Capabilities the task cannot do without."},"required_formats":{"type":"array","items":{"type":"string"},"default":[],"description":"Acceptable delivery formats. An offer matching any one of them qualifies."},"max_price":{"type":"number","minimum":0,"description":"Offers above this are marked ineligible."},"max_delivery_seconds":{"type":"integer","minimum":0,"description":"Offers slower than this are marked ineligible."},"weights":{"type":"object","additionalProperties":false,"description":"Weighting of the three criteria. Normalised to sum 1.","properties":{"price":{"type":"number","minimum":0,"default":0.4},"speed":{"type":"number","minimum":0,"default":0.3},"capability":{"type":"number","minimum":0,"default":0.3}}}}},"requestExample":{"offers":[{"agent":"beispiel","currency":"USDC","capabilities":[],"formats":[]}],"required_capabilities":[],"required_formats":[]}}],"example_request":{"offers":[{"agent":"beispiel","currency":"USDC","capabilities":[],"formats":[]}],"required_capabilities":[],"required_formats":[]},"serviceName":"task_quote_compare","tags":["agent","procurement","comparison"],"outputSchema":{"type":"object"},"outputExample":{"ranked":[{"agent":"beispiel","eligible":true,"ineligible_reasons":[],"score":0.3,"subscores":{"price":null,"speed":null,"capability":1},"price":null,"currency":null,"delivery_seconds":null,"capabilities":[],"missing_capabilities":[],"formats":[],"format_ok":true,"missing_fields":["price","delivery_seconds"],"note":null,"rank":1}],"recommendation":{"agent":"beispiel","score":0.3,"why":"Best weighted result among 1 eligible offers (price 40%, speed 30%, capability 30%)."},"no_eligible_offer":false,"summary":{"offers":1,"eligible":1,"ineligible":0,"currency":"USDC","price_range":null,"delivery_range_seconds":null,"price_spread_factor":null},"weights_used":{"price":0.4,"speed":0.3,"capability":0.3},"required":{"capabilities":[],"formats":[]},"limits":"No currency conversion and no validation that an offer is truthful. The comparison uses the providers' claims. Missing values score zero and are listed under missing_fields."}}