NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Globalping connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Globalping actions, such as "Create Measurement", "Get Rate Limits" and "Get Measurement Results". 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 Globalping, with input parameters and output schema.
GLOBALPING_CREATE_MEASUREMENTTool to create and trigger a network measurement. Use when you need connectivity checks from specific geographic or network locations.
Input parameters
Measurement type to run
Global max probes; mutually exclusive with per-location limit
Publicly reachable target hostname or IP
List of location filters specifying where to run probes. Each filter can use continent, country, city, asn, network, or a 'magic' fuzzy string. Combine filters with '+' in magic (e.g., 'US+AWS'). Defaults to 1 random probe worldwide if omitted.
Stream partial results if true
Options specific to the chosen measurement type
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
GLOBALPING_GET_LIMITSTool to retrieve current rate limits and credits. Use this to check remaining API quota before making measurements. Returns rate limits based on IP address for unauthenticated requests or user account for authenticated requests.
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
GLOBALPING_GET_MEASUREMENTRetrieve measurement results by ID. Use this after creating a measurement to get the status and detailed results from all participating probes. Poll this endpoint until status is 'finished'.
Input parameters
Measurement identifier returned from a create measurement request
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
GLOBALPING_HEALTH_CHECKTool to check API health status. Use when verifying API availability.
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
GLOBALPING_LIST_PROBESRetrieve all currently online Globalping probes worldwide. Returns probe metadata including location (continent, country, city), network information (ASN, ISP name), and tags (datacenter-network, eyeball-network, cloud provider tags). Use max_results parameter to limit response size since the API typically returns ~3500 active probes.
Input parameters
Maximum number of probes to return. The API returns ~3500 active probes by default, so set this to limit the response size (e.g., 10 or 50) for faster processing. Applied as client-side trimming.
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 5 Globalping actions on Nagent, including "Create Measurement", "Get Rate Limits" and "Get Measurement Results". Create Measurement: Create and trigger a network measurement. Each action is listed on this page with its input parameters and its output.
Globalping connects with an API key, 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.
Create Measurement takes 2 required inputs: type and target. It also takes 4 optional inputs: limit, locations, inProgressUpdates and measurementOptions. It returns data, error and successful.