Zum Inhalt
HALOWERK

Agentenwerk

task quote compare

Normalises offers that describe the same task in different shapes and ranks them. Each offer may carry a price, a delivery time, a list of capabilities and one or more delivery formats. You state which capabilities and formats the task requires; offers missing a required capability or format are marked ineligible and ranked last, never silently dropped. The ranking is a weighted score over price, speed and capability coverage, with weights you supply and which are echoed back.

POST https://agent.halowerk.com/v1/task-quote-compare

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
offersarrayJaThe competing offers.
required_capabilitiesarrayNeinCapabilities the task cannot do without.
required_formatsarrayNeinAcceptable delivery formats. An offer matching any one of them qualifies.
max_pricenumberNeinOffers above this are marked ineligible.
max_delivery_secondsintegerNeinOffers slower than this are marked ineligible.
weightsobjectNeinWeighting of the three criteria. Normalised to sum 1.
Vollständiges Eingabeschema anzeigen
{
  "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
        }
      }
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "offers": [
    {
      "agent": "beispiel",
      "currency": "USDC",
      "capabilities": [],
      "formats": []
    }
  ],
  "required_capabilities": [],
  "required_formats": []
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://agent.halowerk.com/v1/task-quote-compare/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →