NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Serply connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Serply actions: "Perform Image Search", "Perform Maps Search" and "Perform Scholar Search". 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 Serply, with input parameters and output schema.
SERPLY_PERFORM_IMAGE_SEARCHPerforms an image search using the Serply API to find images matching a text query. This tool searches for images on the web and returns results with image URLs, thumbnails, dimensions, titles, and source information. Ideal for finding visual content, gathering image references, or discovering images related to specific topics or keywords. Use this when you need to: - Find images matching specific descriptions or keywords - Gather visual references for a topic - Retrieve image URLs for display or download - Search for images with specific characteristics Supports pagination, localization (language/country), and safe search filtering.
Input parameters
Two-letter country code (ISO 3166-1 alpha-2) for geographic localization of search results. For example, 'US' for United States, 'UK' for United Kingdom, 'FR' for France.
Two-letter language code (ISO 639-1) for the language of search results. For example, 'en' for English, 'fr' for French, 'es' for Spanish.
Number of image results to return per page. Default is 10, maximum is 100.
SafeSearch filter to exclude explicit content. Use 'active' to filter adult content, or 'off' to disable filtering. Default is off when not specified.
The search query string to find images. Can be any text describing what images you want to search for.
Starting index for pagination (zero-based). Use this to retrieve results beyond the first page. Default is 0.
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
SERPLY_PERFORM_MAPS_SEARCHTool to perform a maps search. Use when you need to find geographic locations for a given query.
Input parameters
Maximum number of results to return.
The search query for maps (e.g., 'restaurants in Paris').
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
SERPLY_PERFORM_SCHOLAR_SEARCHTool to perform an academic scholar search via Serply. Use when you need scholarly literature search results for a specific query.
Input parameters
Country code for geotargeting, e.g., 'us'.
Language code for results (ISO 639-1), e.g., 'en'.
Number of results to return (max 20).
The search query string for academic literature.
Whether to open result links in a new window.
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 3 Serply actions on Nagent: "Perform Image Search", "Perform Maps Search" and "Perform Scholar Search". Perform Image Search: Performs an image search using the Serply API to find images matching a text query. Each action is listed on this page with its input parameters and its output.
Serply 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.
Perform Image Search takes 1 required input: query. It also takes 5 optional inputs: gl, hl, num, safe and start. It returns data, error and successful.