Skip to content

Deploying and testing tools

Once you’ve created a tool, deploy it to make it available to agents. The deployment process saves the edge function code and registers the tool with the AI API in a single step.

The deployment process handles everything needed to make your tool available:

  1. Edge function code is saved to the global AI project
  2. The tool is registered with the AI API using the JSON schema
  3. The tool becomes available to assign to agents

No additional configuration is required — the deployment process handles function hosting, URL registration, and schema validation automatically.

Click Deploy in the tool creator. This saves the edge function and registers the tool in one step. The deployment status is shown in the tools list, indicating whether the tool is active and available for agents.

Navigate to the tool detail page and use the Test panel to verify your tool works correctly. Provide JSON input matching the tool’s input schema and view the output.

Example test input:

{
"currency": "USD",
"base": "AUD"
}

The test panel displays the raw response from the edge function, along with execution time and any errors. This allows you to verify the tool’s behaviour before assigning it to an agent.

Edit the tool code or schema, then deploy again. The same edge function URL is reused, so agents referencing the tool continue to work with the updated version. There is no need to update agent configurations when you redeploy a tool — the changes take effect immediately.

Deleting a tool removes the tool registration from the AI API. The underlying edge function remains in the global project but is no longer callable by agents.

To delete a tool:

  1. Open the tool from the AI Tools list
  2. Click Delete
  3. Confirm the deletion