search
Read-onlyIdempotent
Search any SeaWeb vertical by natural-language intent.
vertical: one of list_verticals() (e.g. "restaurants"). intent: free
text. location: neighborhood filter; empty = all SF. goal:
discover|book. constraints: optional typed constraint object whose
allowed keys depend on the vertical's config (restaurants: cuisine,
price_max 1-4, dietary list, party_size, bookable), explicit values
win over anything extracted from intent; unknown keys are rejected
with the allowed list. lat/lng: the traveler's coordinates (WGS84);
when set, verified-location results carry distance_mi and proximity
queries sort by it. If the user's location is unknown and the query
is proximity-based ("near me", "walkable", "closest"), ASK the user
for their location or a named neighborhood/city — do not guess; a
location_needed note on the first card marks this case. Use recall()
for the account's stored preferences (e.g. home_neighborhood) when
available. Returns ranked entity cards with canonical
seaweb://{vertical}/{slug} ids.
On corpus verticals the cards may be preceded by a plain-text line,
"[SEAWEB_QUERY] verdict=... [degraded=...]", emitted only when there
is something non-default to say. Other "[SEAWEB_*]" banner lines can
precede it (an experiment marker, when that flag is on), so skip
leading banner lines rather than checking only the first. Read it: `uncertain` means retrieval
returned nothing and is NOT a claim that the corpus lacks the subject
(rephrasing often finds it); `not_found` means a subject term has zero
title hits corpus-wide, which IS an observation about the corpus;
`unsupported_intent` means a list/superlative ask a reference corpus
cannot rank. `degraded=...` means a serving stage failed and the
results are incomplete -- an outage, never an abstention. Absent
header = answerable, nominal.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lng | No | ||
| goal | No | ||
| intent | Yes | ||
| location | No | ||
| vertical | Yes | ||
| constraints | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |