Usare le richieste per fare in modo che l'agente o il flusso dell'agente eseguano attività specifiche

È possibile creare richieste personalizzate per configurare le istruzioni per un servizio Azure OpenAI o un modello di Azure AI Foundry per l'agente personalizzato.

È possibile aggiungere richieste personalizzate a un agente a uno dei due livelli seguenti:

• Livello agente
• Livello di argomento

È anche possibile aggiungere un prompt personalizzato come nodo in un flusso dell'agente. In questo modo è possibile chiamare un prompt in qualsiasi punto del flusso.

Aggiungere una richiesta come strumento ad un agente

1. Selezionare Agenti nel riquadro sinistro e selezionare l'agente a cui si vuole aggiungere una nuova richiesta come strumento.

2. Selezionare la scheda Strumenti .

3. Selezionare Nuovo strumento.

4. Seleziona Richiesta.

   Verrà aperto l'editor di prompt personalizzato. È possibile usare questo editor per creare un prompt personalizzato per l'agente.

Aggiungi un nodo per la richiesta in un argomento

1. Selezionare Agenti nel riquadro sinistro e selezionare l'agente contenente l'argomento da modificare.

2. Aprire un argomento e selezionare l'icona Aggiungi nodo sotto il nodo dopo il quale si vuole aggiungere il nuovo nodo.

3. Seleziona Aggiungi uno strumento>Nuovo prompt.

   Verrà aperto l'editor di prompt personalizzato. È possibile usare questo editor per creare un prompt personalizzato per l'agente.

Aggiungere un nodo di prompt in un flusso agente

1. Selezionare Flussi nel riquadro sinistro e selezionare il flusso dell'agente da modificare.

2. Selezionare l'icona Inserisci nuova azione nel punto nel flusso in cui si vuole aggiungere il nuovo nodo. Verrà visualizzato il riquadro Aggiungi un'azione .

3. In Funzionalità di intelligenza artificiale selezionare Esegui un prompt.

   Un nodo Esegui un prompt viene aggiunto all'area di disegno del flusso.

4. Se si desidera aggiungere un prompt esistente, selezionare tale richiesta dall'elenco. Per aggiungere una nuova richiesta, selezionare Nuovo prompt personalizzato.

   Verrà aperto l'editor di prompt personalizzato. È possibile usare questo editor per creare un prompt personalizzato per l'agente.

Configurare e testare un prompt con l'editor dei prompt

L'editor di prompt personalizzato è uno strumento potente che consente di creare, personalizzare e testare i modelli di prompt per il tuo agente. L'editor di prompt è progettato per aiutarti a creare prompt efficaci per il tuo agente.

L'editor dei prompt consente di scrivere le istruzioni di richiesta in diversi modi. È possibile:

• Scrivere manualmente le proprie istruzioni
• Usa Copilot per generare istruzioni per te in base alla descrizione di ciò che vuoi che il prompt faccia
• Usare un modello predefinito dalla raccolta prompt per creare una richiesta

È possibile configurare diversi aspetti del prompt, tra cui:

• Modello di chat da usare per la richiesta e le impostazioni per il modello, ad esempio temperatura, impostazioni per il recupero delle informazioni, se includere collegamenti nella risposta e se abilitare l'interprete del codice e il ragionamento.
• Input dell'utente alla richiesta, ad esempio testo e immagini, e dati di esempio con cui eseguire il test.
• Conoscenza per elaborare e integrare tabelle da Dataverse.
• Formattazione da applicare all'output.

Al termine della creazione del prompt, è possibile testarlo specificando i dati di esempio per tutti gli input e selezionando Test. L'editor genera una risposta in base al prompt e ai dati di esempio forniti.

Per informazioni dettagliate su come utilizzare l'editor per creare e testare i prompt, vedere Creare un prompt personalizzato nella documentazione del generatore di prompt.

Procedure consigliate per le istruzioni sulle richieste

Quando si utilizza il nodo Richiesta, è importante seguire le procedure consigliate per la progettazione tempestiva. Di seguito alcuni suggerimenti per ottenere il massimo da questa funzionalità:

• Indicare dettagli specifici: le istruzioni personalizzate devono essere chiare e specifiche in modo che l'agente sappia esattamente cosa fare. Evita un linguaggio vago o ambiguo che potrebbe creare confusione o risposte errate.
• Usare gli esempi: fornire esempi per illustrare le istruzioni e aiutare l'agente a comprendere le proprie aspettative. Gli esempi aiutano l'agente a generare risposte precise e pertinenti.
• Evitare le complessità: evitare di inserire troppi dettagli o logica complessa nelle istruzioni personalizzate. Le istruzioni devono essere semplici e dirette affinché l'agente possa elaborarle in modo efficace.
• Mantienilo breve: le istruzioni personalizzate devono essere concise e al punto. Le istruzioni troppo lunghe possono causare latenza, timeout o problemi nella gestione della richiesta.
• Dare all'agente una "via di uscita": offrire all'agente un percorso alternativo quando non è in grado di completare l'attività assegnata. Ad esempio, quando l'utente pone una domanda, è possibile includere "rispondi con "non trovato" se la risposta non è presente". Grazie a questo percorso alternativo, l'agente eviterà di generare risposte false.
• Testare e perfezionare: è importante testare attentamente le istruzioni personalizzate per assicurarsi che funzionino come previsto. Apportare le modifiche necessarie per migliorare la precisione e l'efficacia delle risposte dell'agente.