Agentql connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Agentql actions: "Create Remote Browser Session", "Get AgentQL Usage Statistics" and "Query Data". 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 Agentql, with input parameters and output schema.
AGENTQL_CREATE_REMOTE_BROWSER_SESSIONTool to create a remote browser session. Use when you need to run browser automation on remote infrastructure.
Input parameters
Proxy configuration for the remote browser session.
Browser rendering mode. 'light' provides fast headless browsing. 'stealth' enables anti-detection features for sites that block bots. Defaults to 'light' if not specified.
User agent preset to simulate different operating systems. Defaults to 'linux' if not specified.
Session inactivity timeout in seconds. The session will be automatically terminated after this period of inactivity. Defaults to 300 (5 minutes).
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
AGENTQL_GET_USAGERetrieves API usage statistics and subscription limits for the AgentQL account. Returns current billing cycle dates, lifetime usage limits, API key usage counts, and total account usage. Useful for monitoring quota consumption and planning usage. No parameters required - uses the authenticated API key from connection settings.
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
AGENTQL_QUERY_DATATool to query structured data as JSON from a web page using an AgentQL query or natural language prompt. Use after defining your query or prompt and a URL or HTML.
Input parameters
URL of the public web page to query. Provide either 'url' or 'html'.
Raw HTML content to query. Provide either 'html' or 'url'.
AgentQL query string. Provide either 'query' or 'prompt'.
Parameters controlling wait time, scrolling, extraction mode, and screenshot.
Natural language prompt describing data to extract. Provide either 'prompt' or 'query'.
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 Agentql actions on Nagent: "Create Remote Browser Session", "Get AgentQL Usage Statistics" and "Query Data". Create Remote Browser Session: Create a remote browser session. Each action is listed on this page with its input parameters and its output.
Agentql 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.
It also takes 4 optional inputs: proxy, browser_profile, browser_ua_preset and inactivity_timeout_seconds. It returns data, error and successful.