NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Browser Tool connects to a Nagent workspace with no credentials. Once it is connected, agents can call 5 Browser Tool actions, such as "Get Session Live URL", "Run Browser Task" and "Download Task File". 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 Browser Tool, with input parameters and output schema.
BROWSER_TOOL_CREATE_TASKRun an AI-powered browser automation task. The AI agent will control a cloud browser to complete your task. It can: - Navigate websites, click buttons, fill forms - Extract data and return results - Handle multi-step workflows (login -> navigate -> extract) - Solve CAPTCHAs and handle dynamic content If there is no running browser session in context, call CreateTask to start one. AFTER CREATING A TASK: 1. Use GetSession with browser_session_id to get the liveUrl - share with user to watch live 2. Use WatchTask with watch_task_id to check progress and get the final result 3. Use StopTask if you need to abort TIPS FOR GOOD TASKS: - Be specific: "Click login, enter email 'test@test.com', click submit" - Break complex workflows into smaller tasks
Input parameters
Natural language instructions for the browser AI agent. Be specific and clear. Examples: 'Go to amazon.com, search for wireless headphones, and return the top 3 results with prices', 'Log into twitter.com and post a tweet saying Hello World'. For multi-step workflows, break them into clear sequential instructions.
Domain-specific credentials for automatic login. Map domain patterns to 'username:password'. Example: {'https://example.com': 'user@email.com:pass123', 'https://*.google.com': 'email@gmail.com:password'}. Wildcards (*) supported for subdomains.
URL to navigate to before starting the task. If not provided, agent starts from blank page.
Leave this empty for the first task, a new session will be auto-created. To continue in an existing browser: pass the browser_session_id from a previous CreateTask response. This preserves login state and cookies between tasks. Important: the previous task in this session must be finished or stopped (via StopTask or by waiting for WatchTask to show status='finished') before creating a new task.
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
BROWSER_TOOL_GET_OUTPUT_FILEGet a download URL for a file generated by a task. When a task downloads or creates files (PDFs, images, spreadsheets, etc.), they appear in WatchTask's outputFiles list. Use this to get a download URL. The download URL is temporary (presigned) - download promptly.
Input parameters
File ID from WatchTask's outputFiles list
Task ID from CreateTask
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
BROWSER_TOOL_GET_SESSIONGet the live URL to watch a browser session in real-time. Call this right after CreateTask to get the liveUrl. Always share this URL with the user so they can watch the AI agent working in the browser. The liveUrl opens a visual stream showing exactly what the browser agent sees and does.
Input parameters
The sessionId returned from a CreateTask call you made previously. Only use session IDs from your own CreateTask responses.
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
BROWSER_TOOL_STOP_TASKKill a browser task and its session. Use this when the browser agent is in a bad state: - Task is stuck or taking too long - WatchTask shows the agent going in the wrong direction - Agent is looping or making no progress After stopping, call CreateTask again to start fresh with a new browser.
Input parameters
Task ID to stop (from CreateTask)
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
BROWSER_TOOL_WATCH_TASKPoll a browser task to check progress and get results. Call this after CreateTask to monitor the task: - status='started' means still running, poll again - status='finished' means done, check output and is_success - status='stopped' means aborted - status='failed' means an error occurred Returns what the agent is doing (current_goal, current_url), screenshots from each step, and any files generated. If the agent is going wrong, use StopTask to kill it and start fresh.
Input parameters
The taskId from CreateTask response
Last step number from a previous WatchTask response (current_step value). Only steps after this will be returned for incremental updates. Omit or pass 0 to get all steps.
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 Browser Tool actions on Nagent, including "Get Session Live URL", "Run Browser Task" and "Download Task File". Get Session Live URL: Get the live URL to watch a browser session in real-time. Each action is listed on this page with its input parameters and its output.
Browser Tool 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.
Get Session Live URL takes 1 required input: sessionId. It returns data, error and successful.