Usare gli strumenti condivisi dalla pagina Strumenti

La pagina Strumenti fornisce una posizione centralizzata per gli autori per creare e gestire funzionalità che possono essere usate tra gli agenti all'interno di un ambiente. È possibile creare, gestire e usare strumenti in vari agenti all'interno di un ambiente, rendendo gli strumenti in componenti versatili e riutilizzabili.

Note

La pagina Strumenti sostituisce la pagina Libreria precedente.

È possibile accedere alla pagina Tools in Microsoft Copilot Studio selezionando Tools nel riquadro di spostamento a sinistra.

Quando vai alla pagina Strumenti , vedi una lista di strumenti già aggiunti. Se non vengono ancora aggiunti strumenti, è possibile aggiungere un nuovo strumento selezionando Nuovo strumento. Ogni voce nell'elenco degli strumenti contiene informazioni di base sullo strumento, tra cui nome, tipo, creatore, stato e agenti in cui lo strumento è stato aggiunto.

Pagina dei dettagli dello strumento

Selezionare il nome per uno degli strumenti nell'elenco per visualizzare la pagina dettagli dello strumento. Dalla pagina dei dettagli è possibile:

  • Modificare lo strumento
  • Aggiungere lo strumento a uno o più agenti
  • Esportare lo strumento in una soluzione

Puoi scegliere uno dei selettori sopra l'elenco per filtrare in base al tipo di elemento (agente, connettore, connettore personalizzato, prompt). È inoltre possibile cercare gli elementi in base al nome.

Creare un nuovo strumento

Per creare un nuovo strumento e aggiungerlo alla pagina Strumenti :

  1. Selezionare Nuovo strumento. Ti vengono presentate diverse opzioni:

    • Prompt: crea un nuovo strumento di prompt utilizzando l'editor di prompt builder incorporato.
    • Flussi degli agenti: semplificare i processi aziendali e automatizzare le attività ripetitive. Preconfigurato per iniziare con un trigger dell'agente e terminare con una risposta all'agente.
    • Connettori personalizzati: Collegare sistemi esterni che non dispongono di connettori predefiniti. Integrare API REST o SOAP con piattaforme come Logic Apps, Power Automate, Power Apps o Copilot Studio.
    • API REST: offre un'esperienza guidata per il caricamento di file Swagger per creare strumenti api REST. Questi strumenti vengono utilizzati per collegare gli agenti con fonti di dati esterne o servizi non coperti da connettori preconfigurati.
    • Uso computer: abilitare gli agenti per automatizzare le attività nelle app e nei siti Web facendo clic, digitando ed esplorando l'interfaccia. L'uso di computer è ideale per scenari come l'immissione di dati, l'aggiornamento dei record in un portale Web o il recupero di informazioni dai sistemi senza API.
    • Protocollo di contesto del modello: connettere gli agenti con server di conoscenza e origini dati esistenti per migliorare l'uso di dati strutturati e non strutturati all'interno di Copilot Studio.
  2. Seleziona una delle opzioni. Si procede con il flusso di creazione per lo strumento. Per alcuni strumenti, la creazione avviene nel contesto della pagina Strumenti , mentre per altri vieni reindirizzato a un altro punto di ingresso per la creazione.

Una volta creato uno strumento, appare nella pagina Strumenti . Tutti gli strumenti all'interno dell'ambiente selezionato sono elencati qui, se sei il creatore dello strumento o se il creatore lo ha condiviso con te.

Aggiungere uno strumento a un agente

È possibile aggiungere uno strumento a un agente dalla pagina Strumenti .

Note

Quando si aggiunge uno strumento a più agenti, il componente strumento sottostante (prompt, API REST, connettore personalizzato, flusso agente e così via) rimane invariato. Copilot Studio usa un wrapper intorno allo strumento. Il wrapper consente di specificare input/output e configurazioni specifici per l'implementazione di tale strumento con l'agente.

Selezionare lo strumento

  1. Seleziona i tre punti (...) accanto al nome dello strumento che vuoi aggiungere.

  2. Selezionare Aggiungi all'agente.

I passaggi successivi dipendono dal tipo di strumento.

Aggiungere un comando come strumento a un agente

Per quanto riguarda i prompt, vieni indirizzato alla pagina dei dettagli dello strumento, e puoi aggiungere il prompt a un agente direttamente da lì.

  1. Selezionare Aggiungi.

  2. Selezionare un agente dall'elenco degli agenti.

  3. Selezionare Aggiungi.

Aggiungere altri tipi di strumento a un agente

  1. Selezionare l'agente a cui si vuole aggiungere lo strumento e quindi selezionare Aggiungi.

    Vieni reindirizzato al pannello Aggiungi strumento per l'agente selezionato per aggiungere lo strumento.

  2. Selezionare lo strumento specifico.

    A seconda dello strumento, potresti dover scegliere o creare una connessione per lo strumento.

  3. Selezionare Aggiungi all'agente.

Confronto tra strumenti e librerie

La pagina Strumenti non copre esattamente le stesse funzionalità della precedente pagina della Libreria .

L'elenco seguente indica dove trovare informazioni precedentemente disponibili nella pagina della Biblioteca .

  • agenti Copilot: per creare agenti Copilot (noti anche come agenti dichiarativi) per Microsoft 365 Copilot, passare alla pagina Agents e selezionare Microsoft 365 Copilot>Agents. Qui è possibile visualizzare tutti gli agenti di Copilot esistenti e crearne di nuovi. È anche possibile creare agenti direttamente in Microsoft 365 Copilot.
  • Connettori predefiniti di Power Platform: la pagina Strumenti è una posizione in cui è possibile creare nuovi strumenti da zero. I connettori predefiniti non rientrano in questa categoria. È possibile visualizzare e aggiungere connettori predefiniti dal contesto di un agente.
  • Raccolte di componenti: è possibile visualizzare e creare raccolte dall'interno della pagina Impostazioni per un agente. È anche possibile gestire le raccolte esistenti dalla pagina Soluzioni .
  • Connettori personalizzati: è possibile creare connettori personalizzati dalla pagina Strumenti . Per i connettori predefiniti, è possibile visualizzare e aggiungere dall'interno del contesto di un agente.
  • Flow: disponibile all'interno della pagina Strumenti .
  • Prompt: disponibile all'interno della pagina Strumenti .
  • API REST: disponibile nella pagina Strumenti .

Limitazioni note

Nella pagina Strumenti sono presenti alcuni problemi noti. Alcuni di questi problemi hanno delle mitigazioni che puoi utilizzare.

Emetti Attenuazione
Non è possibile eliminare uno strumento dalla pagina Strumenti Se uno strumento viene creato e aggiunto a un agente, tale strumento può essere rimosso dall'agente accedendo all'agente.
Gli strumenti per l'uso del computer non sono elencati nella homepage degli Strumenti Se uno strumento di uso del computer viene creato e aggiunto a un agente, è elencato nella scheda Strumenti di quell'agente.
I prompt creati in Power Apps, Power Automate o all'interno di un argomento non sono visibili in Copilot Studio. Creare una nuova richiesta in Strumenti. Questo problema è perché l'artefatto del prompt viene avvolto in un plugin prima di essere aggiunto a un agente. Le richieste create in Power Apps, Power Automate e nel contesto di un argomento non vengono incluse nei plug-in. Di conseguenza, questi prompt non vengono visualizzati come strumento disponibile per aggiungere nella pagina *Strumenti .
Quando si modifica il titolo di uno strumento di richiesta, il nuovo nome non viene visualizzato in Strumenti. Modifica il nome dello strumento nella scheda Strumenti dell'agente dove è stato aggiunto.
Quando si crea uno strumento API REST, viene creato anche un connettore personalizzato. Questo comportamento è predefinito.