Generare query NoSQL con Microsoft Copilot per Azure in Cosmos DB (anteprima)

SI APPLICA A: NoSQL

Microsoft Copilot per Azure in Cosmos DB (anteprima) consente di creare query di Azure Cosmos DB for NoSQL generando query basate sui prompt in lingua inglese naturale. Copilot è disponibile per l'uso nell'editor di query dell'API per NoSQL all'interno di Esplora dati. Con Copilot nell'API per NoSQL, è possibile:

• Porre domande sui dati via testo o conversazione per generare una query NoSQL.
• Imparare a scrivere query più velocemente tramite spiegazioni dettagliate della query generata.

Nota

È possibile che il database CopilotSampleDb venga visualizzato in Esplora dati. Si tratta di un database completamente separato gestito da Microsoft e l'accesso viene fornito all'utente (senza costi) come test per acquisire familiarità con Microsoft Copilot per Azure in Cosmos DB. Questo database è costituito da dati sintetici al 100% creati da Microsoft e non ha alcuna interazione o relazioni con i dati che potrebbero essere presenti in Azure Cosmos DB.

Avviso

Copilot è una funzionalità di anteprima basata su modelli di linguaggio di grandi dimensioni. L'output prodotto da Copilot può contenere imprecisioni, distorsioni o altri contenuti imprevisti. Ciò si verifica perché il modello che alimenta Copilot è stato sottoposto a training su informazioni provenienti da Internet e da altre origini. Come per qualsiasi modello di intelligenza artificiale generativa, gli esseri umani devono esaminare l'output prodotto da Copilot prima dell'uso.

Prerequisiti

• Un account Azure Cosmos DB for NoSQL già presente
  • Se non si ha una sottoscrizione di Azure, creare un account gratuitamente.
  • Una volta creato un abbonamento ad Azure, creare un nuovo account Azure Cosmos DB for NoSQL.
  • Registrare la sottoscrizione di Azure in Microsoft Copilot per Azure in Cosmos DB (anteprima).

Importante

Esaminare questi termini di anteprima prima di usare Copilot per le query NoSQL.

Accedere alla funzionalità

Come funzionalità di anteprima, è necessario aggiungere Microsoft Copilot per Azure nell'anteprima di Cosmos DB alla sottoscrizione di Azure. Dopo la registrazione, è possibile trovare Microsoft Copilot per Azure integrato con l'editor di query di Esplora dati.

1. Passare a qualsiasi risorsa NoSQL di Azure Cosmos DB.

2. Selezionare Esplora dati nel riquadro di spostamento.

   

3. Aprire quindi l'esperienza dell'editor di query in uno dei due modi seguenti:

   • Selezionare la scheda Esegui query più velocemente con Copilot nella schermata iniziale di Esplora dati. Questa opzione consente di visualizzare un editor di query destinato al database CopilotSampleDb e al contenitore SampleContainer, che contiene i dati di esempio da usare con Copilot. Questo database viene gestito da Microsoft e non interagisce né si connette agli altri database. CopoilotSampleDb è gratuito per tutti i clienti NoSQL di Azure Cosmos DB.

   • Selezionare un'API esistente per il database e il contenitore NoSQL. Selezionare quindi Nuova query SQL dalla barra dei menu.

Generare una query

È possibile usare Copilot per generare query NoSQL dal testo in linguaggio naturale in qualsiasi contenitore del database.

1. Assicurarsi che l'interfaccia di Copilot sia abilitata. È possibile abilitare l'interfaccia selezionando il pulsante Copilot nel menu di Esplora dati.

2. Immettere una richiesta o una domanda sui dati nell'area di input e quindi attivare la richiesta. Attivare quindi la generazione di una query NoSQL e una spiegazione nell'editor di query.

   

   Avviso

   Come per qualsiasi modello di intelligenza artificiale generativa, gli esseri umani devono esaminare l'output prodotto da Copilot prima dell'uso.

3. Eseguire la query selezionando Esegui query nel menu di Esplora dati.

Invia feedback

Vengono usati commenti e suggerimenti sulle query generate per migliorare ed eseguire il training di Copilot. Questo feedback è fondamentale per migliorare la qualità dei suggerimenti di Copilot.

1. Per inviare commenti e suggerimenti sulle query, usare il meccanismo di feedback all'interno dell'editor di query.

2. Selezionare l'opzione per il feedback positivo o negativo.

   • Il feedback positivo attiva gli strumenti per inviare la query generata a Microsoft come punto dati per cui Copilot ha avuto esito positivo.

   • Il feedback negativo attiva una finestra di dialogo che richiede altre informazioni. Gli strumenti inviano queste informazioni e la query generata a Microsoft per migliorare Copilot.

     

Scrivere richieste valide

Ecco alcuni suggerimenti per scrivere richieste valide.

• Quando si creano richieste di Copilot, assicurarsi di iniziare con una descrizione chiara e concisa delle informazioni specifiche che si stanno cercando. Se non si è certi della struttura dei dati, eseguire la query SELECT TOP 1 - FROM c per visualizzare il primo elemento nel contenitore.

• Usare parole chiave e contesto rilevanti per la struttura degli elementi nel contenitore. Questo contesto consente a Copilot di generare query accurate. Specificare le proprietà e i criteri di filtro il più possibile espliciti. Copilot deve essere in grado di correggere gli errori di digitazione o comprendere il contesto in base alle proprietà degli elementi esistenti nel contenitore.

• Evitare un linguaggio ambiguo o eccessivamente complesso nelle richieste. Semplificare la domanda mantenendone la chiarezza. Questa modifica garantisce che Copilot possa convertirla in modo efficace in una query NoSQL significativa che recupera i dati desiderati dal contenitore.

• I prompt di esempio seguenti sono chiari, specifici e personalizzati in base alle proprietà degli elementi di dati, semplificando la generazione di query NoSQL accurate da parte di Copilot:

  • Show me a product
  • Show all products that have the word "ultra" in the name or description
  • Find the products from Japan
  • Count all the products, group by each category
  • Show me all names and prices of products that reviewed by someone with a username that contains "Mary"

Passaggio successivo

Esaminare le domande frequenti su Copilot