NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Bonsai connects to a Nagent workspace. Once it is connected, agents can call 3 Bonsai actions: "Get Bonsai Cluster Details", "List Spaces" and "Retrieve Space Details". 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 Bonsai, with input parameters and output schema.
BONSAI_GET_CLUSTER_DETAILSTool to retrieve details for a single bonsai cluster by slug. Use when you need to inspect a cluster's configuration and status.
Input parameters
Unique, machine-readable slug identifying the bonsai cluster.
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
BONSAI_GET_SPACE_DETAILSTool to retrieve details for a single space by its path. Use when you need metadata for a space before provisioning a cluster. Use after confirming this detail exists. E.g., 'omc/bonsai/us-east-1/common'.
Input parameters
The machine-readable path of the space to retrieve details for, e.g., 'omc/bonsai/us-east-1/common'.
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
BONSAI_LIST_SPACESTool to retrieve a list of all available spaces. Use when you need to see the server groups and geographic regions available for your account.
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 Bonsai actions on Nagent: "Get Bonsai Cluster Details", "List Spaces" and "Retrieve Space Details". Get Bonsai Cluster Details: Retrieve details for a single bonsai cluster by slug. Each action is listed on this page with its input parameters and its output.
Get Bonsai Cluster Details takes 1 required input: slug. It returns data, error and successful.