search

tech.seaweb/seaweb · Verify this server

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.