Gestire ed eliminare le abilità di un agente

Dopo che hai aggiunto competenze al tuo agente, puoi modificarle, scaricarle, sostituirle ed eliminarle dalla scheda Crea. Una corretta organizzazione e un costante aggiornamento delle competenze del tuo agente garantiscono la migliore esperienza utente.

Annotazioni

Le funzionalità di questo articolo sono utilizzate da agenti o flussi di lavoro alimentati dall'harness GitHub Copilot.

La fatturazione basata sull'uso si applica all'utilizzo, alla costruzione, al test e alla valutazione degli agenti. Queste azioni potrebbero consumare crediti Copilot. Scopri di più in Gestire i costi per agenti alimentati dal GitHub Copilot harness.

Visualizzare le competenze dell'agente

  1. Aprire l'agente in Copilot Studio.

  2. Seleziona la scheda Crea.

  3. Nel pannello dei componenti, la sezione Competenze mostra le competenze che hai aggiunto al tuo agente.

Modificare una competenza che hai creato da zero

Puoi modificare le competenze che hai creato da zero direttamente nel pannello di configurazione delle competenze.

  1. Seleziona la competenza da modificare per aprire il pannello di configurazione.

  2. Aggiorna uno qualsiasi degli elementi seguenti:

    • Nome: l'identificatore della competenza. Usa solo lettere minuscole, numeri e trattini. Non iniziare o terminare il nome con un trattino.
    • Descrizione: spiega cosa fa la competenza e quando dovrebbe essere attivata.
    • Istruzioni: le istruzioni Markdown che guidano il comportamento dell'agente.

  3. Selezionare Salva per applicare le modifiche.

Tip

Dopo aver modificato una competenza, testa il tuo agente nella scheda Anteprima per verificare che le modifiche funzionino come previsto.

Scaricare una funzionalità

Puoi scaricare una competenza per condividerla con altri o effettuarne il backup.

  1. Seleziona la competenza che desideri scaricare per aprire il pannello di configurazione.

  2. A seconda della competenza:

    • Se hai creato la skill partendo da zero, seleziona l'icona Download.

    • Se hai caricato l'abilità, seleziona i tre puntini (…) e quindi seleziona Scarica.

La competenza viene scaricata come file Markdown contenente il nome e la descrizione della competenza nel front matter YAML, oltre alle istruzioni. Il nome del file corrisponde al nome della competenza.

Sostituisci un'abilità che hai caricato

Dopo aver modificato le istruzioni per una competenza esistente nel tuo editor di testo preferito, carica le modifiche sostituendo la versione corrente della competenza nel tuo agente. Puoi anche sostituire una competenza con un'altra.

  1. Seleziona la competenza che vuoi sostituire per aprire il pannello di configurazione.

  2. Seleziona i puntini di sospensione (…), quindi seleziona Sostituisci.

  3. Individua il file di skill che desideri e selezionalo.

Eliminare una competenza

  1. Nel pannello dei componenti, seleziona l'icona X accanto alla competenza che vuoi eliminare. Un messaggio ti chiede di confermare l'operazione.

  2. Selezionare Elimina per confermare l'eliminazione.

Annotazioni

L'eliminazione di una competenza la rimuove definitivamente da questo agente. Se pensi che la competenza possa servirti nuovamente in futuro, scaricala prima.

Abilità di risoluzione dei problemi che non si caricano

Se un'abilità che hai aggiunto non appare nel pannello componenti dopo aver salvato, o l'agente si comporta come se l'abilità non fosse installata, probabilmente l'abilità ha fallito un controllo di caricamento. Copilot Studio continua comunque a caricare il resto dell'agente quando ciò accade, ma l'abilità interessata viene ignorata.

Le ragioni più comuni per cui una competenza viene saltata e la soluzione per ciascuna:

Ragione Che cosa significa Come risolverlo
Frontmatter YAML non valido Il --- blocco in cima a SKILL.md non è valido YAML. Citare valori di stringhe che contengono due punti o un altro metacarattere YAML (ad esempio, description: "My: skill"). Verifica che il frontmatter sia una mappatura di coppie key: value.
Mancante name Il frontmatter non ha un valore non vuoto name: . Aggiungi name: <skill-name> al frontmatter.
Mancante description Il frontmatter non ha un valore non vuoto description: . Aggiungi description: <one-line summary> al frontmatter.
Descrizione troppo lunga L'description effettivo è più lungo di quanto il catalogo visibile al modello possa accettare. Accorcia la descrizione a una sola riga che riassuma lo scopo dell'abilità.
Nome dell'abilità duplicato Due abilità nello stesso agente usano lo stesso nome di cartella. Rinomina una delle abilità in modo che ognuna abbia un nome unico.
Illegibile SKILL.md Il SKILL.md file non poteva essere letto, di solito a causa di una codifica non-UTF-8. Salva SKILL.md come UTF-8 senza BOM, quindi carica nuovamente l'abilità.
Il file di risorse non è stato scritto Non è stato possibile scrivere uno o più file di supporto nel pacchetto della skill. Riesporta il pacchetto di competenze, verifica che ogni file sia presente e leggibile, poi carica di nuovo.
Pacchetto di competenze rifiutato Il pacchetto di competenze non ha superato un controllo di convalida strutturale durante l'installazione. Esporta di nuovo il pacchetto da un editor funzionante e riprova. Se il problema si ripresenta con un pacchetto che funzionava prima, contatta il tuo amministratore.

Le abilità i cui file di supporto sono stati parzialmente scritti continuano a caricare, ma l'agente potrebbe comportarsi diversamente in tempo reale perché parte del contenuto citato manca. Ricarica il pacchetto per ripristinare l'intero set di file.

  • Last updated on