NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Roboflow connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Roboflow actions, such as "Get Execution Engine Versions", "Get Server Info" and "Get Server Metrics". 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 Roboflow, with input parameters and output schema.
ROBOFLOW_DESCRIBE_WORKFLOW_INTERFACETool to describe the interface of a workflow specification. Use when you need to understand the inputs, outputs, and types for a Roboflow workflow definition.
Input parameters
Roboflow API Key that will be passed to the model during initialization for artifact retrieval
Workflow specification object containing version, inputs, steps, and outputs. Must include: version (string), inputs (list of input definitions), steps (list of step definitions), and outputs (list of output definitions).
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
ROBOFLOW_GET_EXECUTION_ENGINE_VERSIONSTool to retrieve available Execution Engine versions from Roboflow workflows API. Use when you need to check which execution engine versions are supported for workflow processing.
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
ROBOFLOW_GET_SERVER_INFOTool to retrieve information about the Roboflow inference server. Use when you need to check the server version, name, or unique identifier.
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
ROBOFLOW_GET_SERVER_METRICSTool to retrieve Prometheus metrics from the Roboflow inference server. Use when monitoring server performance, tracking inference statistics, or debugging server health issues.
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
ROBOFLOW_GET_WORKFLOW_SCHEMATool to fetch the workflows block schema from Roboflow. Use when you need to retrieve the complete schema definition for workflow blocks.
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
ROBOFLOW_RUN_WORKFLOWTool to run a workflow specification with provided inputs. Use when you need to execute a custom Roboflow workflow pipeline for image processing, model inference, or other computer vision tasks.
Input parameters
Dictionary containing runtime values for each parameter defined as an input in the workflow specification. Keys must match the 'name' fields defined in specification.inputs. Values can be of various types depending on the input type (e.g., for InferenceImage input, provide object with 'type' and 'value' keys where type can be 'url', 'base64', or 'numpy').
Roboflow API Key passed to the model during initialization for artifact retrieval. If not provided, uses the authentication from metadata headers.
Reserved flag used internally by Roboflow to distinguish between preview and non-preview runs.
Optional identifier of the workflow. Used when running a saved workflow definition from Roboflow platform.
Workflow specification object defining version, inputs, steps, and outputs. Must include 'version' (string), 'inputs' (array of input definitions), 'steps' (array of processing steps), and 'outputs' (array of output definitions). Each input must have 'type' and 'name'. Each step must have 'type' and 'name' with additional configuration. Each output must have 'type', 'name', and 'selector'.
List of field names to exclude from the response among those defined in workflow specification outputs.
Flag to request workflow run profiling. Enables workflow profiler only when server settings allow profiling traces to be exported to clients. Only applies for workflow definitions saved on Roboflow platform.
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
ROBOFLOW_VALIDATE_WORKFLOWTool to validate a Roboflow workflow specification before execution. Use this to check if your workflow definition is syntactically correct and properly structured.
Input parameters
List of workflow steps that process the inputs and produce intermediate results.
List of workflow inputs that define the data flowing into the workflow.
Roboflow API Key that will be passed to the model during initialization for artifact retrieval. If not provided, uses the authentication from metadata.
List of workflow outputs that extract final results from the steps.
Version of the workflow specification format.
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 7 Roboflow actions on Nagent, including "Get Execution Engine Versions", "Get Server Info" and "Get Server Metrics". Get Execution Engine Versions: Retrieve available Execution Engine versions from Roboflow workflows API. Each action is listed on this page with its input parameters and its output.
Roboflow 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 returns data, error and successful.