Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
In questa esercitazione si userà il playground di test nel portale dell'agente SRE di Azure per testare ed eseguire il debug degli strumenti prima di distribuirli. Il playground consente di eseguire strumenti in isolamento usando parametri personalizzati ed esaminare immediatamente i risultati.
In questa esercitazione apprenderai a:
- Accedere al playground di test per qualsiasi strumento
- Testare uno strumento Kusto con query in tempo reale
- Testare uno strumento di sistema con parametri personalizzati
- Verificare i risultati prima della distribuzione
Tempo stimato: 5 minuti
Prerequisiti
Prima di iniziare, assicurarsi di avere gli elementi seguenti:
- Almeno uno strumento creato (strumento Kusto o strumento di sistema). Per altre informazioni, vedere Creare uno strumento Kusto.
- Accesso al portale dell'agente SRE.
Aprire il parco giochi
Andare al playground di test nel canvas dell'agente.
- Aprire il portale dell'agente SRE e selezionare l'agente.
- Selezionare Builder>Agent Canvas.
- Selezionare Test playground nel selettore di visualizzazione (accanto a Visualizzazione canvas e Visualizzazione tabella).
Il playground mostra uno stato vuoto con un selettore agente/strumento personalizzato nella parte superiore e il messaggio "Selezionare un agente o uno strumento per avviare una sessione del playground".
Selezionare lo strumento
Scegliere lo strumento da testare dal selettore di entità.
- Selezionare l'elenco a discesa Agente personalizzato/Strumento nella parte superiore.
- Esplorare o cercare nell'elenco. Ogni voce mostra un'etichetta secondaria che ne indica il tipo, ad esempio Autonomo per gli agenti personalizzati, Strumento Integrato per strumenti di sistema o Strumento Kusto per strumenti Kusto.
- Selezionare lo strumento da testare.
- Seleziona Applica.
Il playground carica la configurazione e l'interfaccia di test dello strumento selezionato.
Testare uno strumento Kusto
Se è stato selezionato uno strumento Kusto, seguire questa procedura per testarlo.
- Esaminare il pannello sinistro, che mostra la configurazione delle query (cluster, database, testo di query e definizioni di parametri).
- Nel pannello destro compilare i valori dei parametri richiesti dalla query.
- Selezionare Esegui test.
Il pannello di test mostra le informazioni seguenti:
- Stato di esito positivo o negativo
- Numero di righe e colonne restituite
- Risultati delle query visualizzati in una tabella
- Tempo di esecuzione in millisecondi
Un indicatore di esito positivo verde conferma che la query viene eseguita correttamente nel cluster connesso.
Annotazioni
Il pulsante Salva è disabilitato fino a quando non si esegue un test riuscito. Questa condizione garantisce che vengano salvate solo le query che funzionano effettivamente contro il tuo cluster.
Suggerimento
Se la query restituisce risultati imprevisti, modificare KQL e selezionare di nuovo Esegui test. È possibile eseguire l'iterazione senza uscire dal parco giochi.
Testare uno strumento di sistema
Se si seleziona uno strumento di sistema, seguire questa procedura per testarlo.
- Esaminare il pannello sinistro, che mostra le informazioni sullo strumento (nome, descrizione, plug-in e categoria).
- Nel pannello destro compilare i valori dei parametri obbligatori.
- Selezionare Esegui strumento.
Lo strumento esegue e visualizza l'output JSON in un editor incorporato. Verificare che l'output corrisponda al comportamento previsto per gli input.
Verificare ed eseguire l'iterazione
Dopo il test, esaminare i risultati e perfezionare in base alle esigenze.
- Strumento Kusto: se i risultati non sono corretti, modificare KQL e rieseguire. Selezionare Salva quando la query è corretta. Il salvataggio è abilitato solo dopo un'esecuzione di test riuscita.
- Strumento di sistema: se l'output è imprevisto, controllare i valori dei parametri ed eseguire di nuovo.
Le modifiche apportate agli strumenti Kusto vengono salvate quando si seleziona Salva. Gli strumenti di sistema non richiedono il salvataggio perché vengono eseguiti usando i parametri specificati.
Risoluzione dei problemi
Usare le informazioni seguenti per risolvere i problemi comuni.
Nessun strumento visualizzato nel selettore
È necessario almeno uno strumento creato. Nella barra degli strumenti del canvas dell'agente, selezionare Crea>Strumento>strumento Kusto per crearne uno.
Lo strumento Kusto mostra "Nessun connettore configurato"
Il test dello strumento Kusto richiede un connettore dati. Passare a Generatore>Connettori e aggiungere un connettore Azure Data Explorer usando l'URL del cluster e il database. Tornare quindi al playground e selezionare di nuovo lo strumento Kusto.
Il test Kusto mostra l'errore di autorizzazione
L'agente deve accedere al cluster Kusto. Controllare gli elementi seguenti:
- Hai configurato un connettore dati per il cluster sotto Builder>Connettori.
- Le credenziali del connettore dispongono delle autorizzazioni di query per il database di destinazione.
Lo strumento di sistema restituisce un errore
Verificare gli elementi seguenti:
- Sono stati compilati tutti i parametri obbligatori.
- I valori dei parametri corrispondono al formato previsto (stringhe, numeri e valori simili).
- Il nome e il plug-in dello strumento sono configurati correttamente.
Gli strumenti Python non sono elencati
Gli strumenti Python hanno una propria interfaccia di test all'interno dell'editor degli strumenti Python. Apri l'editor dal Canvas dell'Agente. Per testare uno strumento Python, usare il pannello di test predefinito nell'editor.