NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
OpenWeatherMap connects to a Nagent workspace with no credentials. Once it is connected, agents can call 2 OpenWeatherMap actions: "Geocode Location to Coordinates" and "Weather Info". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against OpenWeatherMap, with input parameters and output schema.
WEATHERMAP_GEOCODE_LOCATIONTool to resolve a human place name into canonical lat/lon coordinates using OpenWeather Geocoding API. Use when you need to convert location strings (city names, addresses) into coordinates for weather forecasts or other location-based queries. Returns up to 5 candidate matches; the first result is typically the most relevant.
Input parameters
Location query string in format 'city' or 'city,country_code' or 'city,state,country_code'. For US locations, you can include state code (e.g., 'Austin,TX,US'). Use ISO 3166 country codes (e.g., 'London,GB', 'Paris,FR'). The API supports 200,000+ registered locations.
Maximum number of location matches to return (1-5). Use this to limit results when multiple locations share the same name. Default is 5.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
WEATHERMAP_WEATHERTool for querying the OpenWeatherMap API. Returns current weather conditions only — no UV index, AQI, or official alerts. Timestamps are in UTC; apply the timezone offset field before grouping by local day.
Input parameters
A real city name (e.g., 'London', 'New York', 'Tokyo'). MUST be an actual city name - NOT a placeholder like 'your location', 'current location', or 'my location'. City names must be in English/Latin characters only. You may optionally append a country code (e.g., 'London,GB'). For US cities with state abbreviations, use the 3-part format 'City,StateCode,US' (e.g., 'Redding,CA,US', 'Portland,OR,US') - the 2-part format 'City,StateCode' will be interpreted as a country code (e.g., 'CA' = Canada, not California). If a 'city not found' error occurs, retry with a simpler string (e.g., drop state code, use just 'City' or 'City,CountryCode'). Small or remote locations may return no data; handle gracefully rather than retrying indefinitely.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 2 OpenWeatherMap actions on Nagent: "Geocode Location to Coordinates" and "Weather Info". Geocode Location to Coordinates: Resolve a human place name into canonical lat/lon coordinates using OpenWeather Geocoding API. Each action is listed on this page with its input parameters and its output.
OpenWeatherMap connects with no credentials, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Geocode Location to Coordinates takes 1 required input: q. It also takes 1 optional input: limit. It returns data, error and successful.