Tool tree
Universal Agent Gateway helps AI agents access public websites through bounded, structured, read-only tools.
Implementation
gradeNot graded
gradeNot graded
gateway_taskAnswer
Runs a read-only task against supported public website sources and returns matching records, provenance, coverage, and structured answer state. The task is for public-site search or extraction; it does not mutate contacts or records, execute transactions, or retrieve an existing result_ref.
View tool JSON
{
"name": "gateway_task",
"kind": "answer",
"impl": "imperative",
"description": "Runs a read-only task against supported public website sources and returns matching records, provenance, coverage, and structured answer state. The task is for public-site search or extraction; it does not mutate contacts or records, execute transactions, or retrieve an existing result_ref.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"goal": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"description": "The normal-language read-only request."
},
"site": {
"type": "string",
"minLength": 3,
"maxLength": 300,
"description": "Optional public site URL or domain."
},
"response_format": {
"type": "string",
"enum": [
"concise",
"detailed"
],
"description": "Optional response size."
},
"operation": {
"type": "string",
"enum": [
"search",
"detail"
],
"description": "Optional universal operation."
},
"entity_type": {
"type": "string",
"enum": [
"product",
"job",
"article",
"rental",
"lodging",
"discussion",
"video",
"unknown"
],
"description": "Optional record type for the universal task."
},
"query": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"description": "Optional bounded search phrase."
},
"detail_url": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"description": "Optional public detail URL for structured extraction."
},
"candidate_urls": {
"type": "array",
"maxItems": 5,
"items": {
"type": "string",
"minLength": 3,
"maxLength": 1000
},
"description": "Optional public URLs to evaluate when site search is unavailable."
},
"sites": {
"type": "array",
"minItems": 1,
"maxItems": 3,
"items": {
"type": "string",
"minLength": 3,
"maxLength": 300
},
"description": "Optional list of up to three public targets."
},
"constraints": {
"type": "array",
"maxItems": 12,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"field": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Constraint field."
},
"operator": {
"type": "string",
"enum": [
"eq",
"neq",
"lt",
"lte",
"gt",
"gte",
"contains",
"in"
],
"description": "Constraint operator."
},
"value": {},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 24,
"description": "Optional unit."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"required": {
"type": "boolean"
}
}
},
"description": "Optional explicit record constraints."
},
"sort": {
"type": "object",
"additionalProperties": false,
"description": "Optional result ordering by field and direction.",
"properties": {
"field": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Sort field."
},
"direction": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Sort direction."
}
}
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Maximum universal results to return."
},
"locale": {
"type": "object",
"additionalProperties": false,
"description": "Optional language, market, currency, and timezone context for interpreting source data.",
"properties": {
"language": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Language tag."
},
"market": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Market code."
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"timezone": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "IANA timezone."
}
}
}
},
"required": [
"goal"
]
}
}gateway_get_resultAnswer
Retrieves and revalidates the full public record represented by a result_ref returned by gateway_task, including identity, source provenance, and coverage. It is read-only and does not perform arbitrary record searches or writes.
View tool JSON
{
"name": "gateway_get_result",
"kind": "answer",
"impl": "imperative",
"description": "Retrieves and revalidates the full public record represented by a result_ref returned by gateway_task, including identity, source provenance, and coverage. It is read-only and does not perform arbitrary record searches or writes.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"result_ref": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "Opaque public result reference returned by the gateway."
}
},
"required": [
"result_ref"
]
}
}gateway_capabilitiesAnswer
Returns capability metadata, supported operation groups, and structured planning information for a requested scope.
View tool JSON
{
"name": "gateway_capabilities",
"kind": "answer",
"impl": "imperative",
"description": "Returns capability metadata, supported operation groups, and structured planning information for a requested scope.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"capability": {
"type": "string",
"enum": [
"commerce",
"rentals",
"jobs",
"all"
],
"description": "Capability group associated with the metadata; defaults to all."
},
"scope": {
"type": "string",
"enum": [
"commerce",
"rentals",
"jobs",
"diagnostics",
"compatibility",
"all"
],
"description": "Optional scope associated with capability metadata."
},
"goal": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"description": "Optional short description associated with the capability request."
},
"level": {
"type": "string",
"enum": [
"overview",
"advanced"
],
"description": "Optional level of capability detail."
}
},
"required": []
}
}