Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
In this tutorial, you use the test playground in the Azure SRE Agent portal to test and debug your tools before deploying them. The playground lets you execute tools in isolation by using custom parameters and review results immediately.
In this tutorial, you learn how to:
- Access the test playground for any tool
- Test a Kusto tool with live queries
- Test a system tool with custom parameters
- Verify results before deploying
Estimated time: 5 minutes
Prerequisites
Before you begin, make sure you have the following items:
- At least one tool created (Kusto tool or system tool). For more information, see Create a Kusto tool.
- Access to the SRE Agent portal.
Open the playground
Go to the test playground in the Agent Canvas.
- Open the SRE Agent portal and select your agent.
- Select Builder > Agent Canvas.
- Select Test playground in the view toggle (next to Canvas view and Table view).
The playground shows an empty state with a Custom agent/Tool selector at the top and the message "Select an agent or tool to start a playground session."
Select your tool
Choose the tool you want to test from the entity selector.
- Select the Custom agent/Tool dropdown at the top.
- Browse or search the list. Each entry shows a sublabel indicating its type, such as Autonomous for custom agents, Built-in Tool for system tools, or Kusto tool for Kusto tools.
- Select the tool you want to test.
- Select Apply.
The playground loads the selected tool's configuration and test interface.
Test a Kusto tool
If you selected a Kusto tool, use the following steps to test it.
- Review the left panel, which shows your query configuration (cluster, database, query text, and parameter definitions).
- In the right panel, fill in any parameter values required by your query.
- Select Run test.
The test panel shows the following information:
- Success or failure status
- Row count and columns returned
- Query results displayed in a table
- Execution time in milliseconds
A green success indicator confirms your query runs correctly against the connected cluster.
Note
The Save button is disabled until you run a successful test. This condition ensures you only save queries that actually work against your cluster.
Tip
If the query returns unexpected results, adjust your KQL and select Run test again. You can iterate without leaving the playground.
Test a system tool
If you select a system tool, use the following steps to test it.
- Review the left panel, which shows the tool information (name, description, plugin, and category).
- In the right panel, fill in the required parameter values.
- Select Execute Tool.
The tool executes and displays JSON output in an embedded editor. Verify the output matches the expected behavior for your inputs.
Verify and iterate
After testing, review the results and refine as needed.
- Kusto tool: If results are incorrect, adjust your KQL and rerun. Select Save when the query is correct. Save is only enabled after a successful test run.
- System tool: If output is unexpected, check your parameter values and re-execute.
Changes to Kusto tools are saved when you select Save. System tools don't require saving because they execute by using the parameters you provide.
Troubleshooting
Use the following information to resolve common issues.
No tools appear in the selector
You need at least one tool created. In the Agent Canvas toolbar, select Create > Tool > Kusto tool to create one.
Kusto tool shows "No connectors configured"
The Kusto tool test needs a data connector. Go to Builder > Connectors and add an Azure Data Explorer connector by using the cluster URL and database. Then return to the playground and select your Kusto tool again.
Kusto test shows authorization error
Your agent needs access to the Kusto cluster. Check the following items:
- You configured a data connector for the cluster under Builder > Connectors.
- The connector credentials have query permissions on the target database.
System tool returns an error
Verify the following items:
- You filled in all required parameters.
- Parameter values match the expected format (strings, numbers, and similar values).
- The tool name and plugin are correctly configured.
Python tools aren't listed
Python tools have their own test interface inside the Python tool editor. Open the editor from the Agent Canvas. To test a Python tool, use the built-in test panel in the editor.