Skip to content
Wysp Docs

hypertool

Handle arbitrary natural language that seems to be related to maps/geospatial/navigation, something you would expect to be handled by a “Maps App”.

{
"input": "will it be open?", // "Maps App"-relevant input
}
{
"value": "Yes - Café Sara is open until 3:30am tonight.", // String response value
"kind": "SUCCESS", // SUCCESS | FAILURE | BAD_REQUEST | INTERNAL_SERVER_ERROR | REFUSAL
"nature": "USER_VERBATIM", // OPAQUE | USER_VERBATIM | JSON
"language": "en-US", // BCP47 language tag
}
Call this tool when:
- the user asks by name about a place, address, business, etc.
- you need want to lookup the location, distance, rating, opening hours, or description of a place
- the user asks specifically for a stop to be added to their route
- the user says they are using a different mode of transport, or implies it by saying they want to walk somewhere or drive somewhere
- the user asks for guidance on which direction they should be heading
- the user responds to a question asked by the Maps App
- the user ask for followup or clarification to information provided by the Maps App