Aggiungere origini di conoscenza a un agente dichiarativo creato con Microsoft 365 Agents Toolkit

Suggerimento

Consigliato: Inizia con Work IQ Dev Tools per scenari di agenti dichiarativi e plug-in pro-code supportati. Vedere la guida introduttiva di WIQD. Le istruzioni basate su toolkit rimangono disponibili per i progetti e i flussi di lavoro esistenti che le richiedono. Controlla il supporto per le funzionalità e l'esperienza di destinazione prima di scegliere uno strumento: WIQD non si rivolge agli agenti del motore personalizzato.

È possibile controllare le conoscenze disponibili all'agente per la generazione di risposte con origini di conoscenza dal Web e dai dati dell'organizzazione Microsoft 365. Per un elenco completo delle origini dati disponibili, vedere Aggiunta di origini dati all'agente dichiarativo.

Importante

Questa guida presuppone che sia stata completata l'esercitazione Creare agenti dichiarativi usando il Toolkit per agenti di Microsoft 365 e JSON .

Aggiungere la ricerca Web all'agente

L'aggiunta della ricerca web al tuo agente gli consente di cercare sul web per generare risposte. Facoltativamente, è possibile limitare le informazioni a siti Web specifici.

  1. Aprire il appPackage/declarativeAgent.json file e aggiungere la capabilities matrice con il contenuto seguente.

    "capabilities": [
      {
        "name": "WebSearch"
      }
    ]
    

    Per ulteriori informazioni, vedere Oggetto di ricerca Web.

  2. Seleziona Provisioning nel pannello Ciclo di vita di Microsoft 365 Agents Toolkit.

L'agente dichiarativo ha accesso al contenuto Web per generare le risposte dopo aver ricaricato la pagina.

Screenshot che mostra una risposta dell'agente dichiarativo che include contenuto Web

Aggiungere un sito di SharePoint all'agente

È possibile aggiungere file in OneDrive o nei contenuti dei siti di SharePoint come origine delle informazioni.

  1. Aprire il appPackage/declarativeAgent.json file e aggiungere il valore seguente alla matrice, sostituendolo https://contoso.sharepoint.com/sites/ProductSupport con un URL del sito di SharePoint nell'organizzazione capabilities di Microsoft 365.

    {
      "name": "OneDriveAndSharePoint",
      "items_by_url": [
        {
          "url": "https://contoso.sharepoint.com/sites/ProductSupport"
        }
      ]
    }
    

    Per altre informazioni, vedere OneDrive e oggetto SharePoint.

    Nota

    • Gli URL devono essere il percorso completo degli elementi di SharePoint (sito, raccolta documenti, cartella o file). È possibile usare l'opzione "Copia collegamento diretto" in SharePoint per ottenere il percorso completo o i file e le cartelle. Fai clic con il pulsante destro del mouse sul file o sulla cartella e seleziona Dettagli. Passa a Percorso e seleziona l'icona di copia.
    • Se non si specifica la matrice (o la matrice alternativaitems_by_sharepoint_ids), tutto il items_by_url contenuto di OneDrive e SharePoint dell'organizzazione di Microsoft 365 disponibile per l'utente connesso sarà disponibile per l'agente.
  2. Seleziona Provisioning nel pannello Ciclo di vita di Agents Toolkit.

L'agente dichiarativo ha accesso al contenuto di OneDrive e SharePoint per generare le risposte dopo aver ricaricato la pagina.

Screenshot che mostra una risposta dell'agente dichiarativo che contiene il contenuto di SharePoint e OneDrive

Aggiungere messaggi di Teams all'agente

  1. Aprire il appPackage/declarativeAgent.json file e aggiungere il capabilities valore seguente alla matrice, sostituendolo https://teams.microsoft.com/l/team/... con un URL del canale o del team di Teams dell'organizzazione.

    {
      "name": "TeamsMessages",
      "urls": [
        {
          "url": "https://teams.microsoft.com/l/team/..."
        }
      ]
    }
    

    Per altre informazioni, vedere Oggetto messaggi di Microsoft Teams.

    Nota

    • L'URL nella url proprietà deve essere un collegamento ben formato a una chat, un team o una chat di riunione di Teams.
    • Se non si specifica la matrice, tutti i canali, i team, le urls riunioni, le chat 1:1 e le chat di gruppo dell'organizzazione di Microsoft 365 disponibili per l'utente connesso saranno disponibili per l'agente.
  2. Seleziona Provisioning nel pannello Ciclo di vita di Agents Toolkit.

L'agente dichiarativo ha accesso ai dati di Teams per generare le risposte dopo aver ricaricato la pagina.

Screenshot che mostra una risposta dell'agente dichiarativo che contiene il contenuto di Teams

Aggiungere le informazioni sulle persone all'agente

L'origine delle conoscenze personali consente di definire l'ambito dell'agente per rispondere a domande sugli utenti di un'organizzazione.

  1. Apri il appPackage/declarativeAgent.json file e aggiungi la People voce alla capabilities matrice.

    {
      "name": "People"
    }
    

    Per ulteriori informazioni, vedere Oggetto People.

  2. Seleziona Provisioning nel pannello Ciclo di vita di Agents Toolkit.

L'agente dichiarativo ha accesso alle conoscenze delle persone dopo aver ricaricato la pagina.

Screenshot che mostra una risposta dell'agente dichiarativo che contiene le informazioni sugli utenti

Aggiungere messaggi di posta elettronica all'agente

L'origine delle conoscenze e-mail consente di definire l'ambito dell'agente in modo che utilizzi la posta elettronica proveniente dalla cassetta postale dell'utente o da una cassetta postale condivisa per rispondere alle query.

  1. Apri il appPackage/declarativeAgent.json file e aggiungi la Email voce alla capabilities matrice.

    {
      "name": "Email",
      "folders": [
        {
          "folder_id": "inbox"
        }
      ]
    }
    

    Per ulteriori informazioni, vedere Oggetto Email.

    Nota

    • Questo esempio accede all'utente della cassetta postale dell'agente. Per accedere invece a una cassetta postale condivisa, aggiungere la proprietà facoltativa shared_mailbox impostata sull'indirizzo di posta elettronica della cassetta postale condivisa.
    • La folders matrice limita l'accesso della cassetta postale a cartelle specifiche. Per accedere all'intera cassetta postale, omettere la folders matrice.
  2. Seleziona Provisioning nel pannello Ciclo di vita di Agents Toolkit.

L'agente dichiarativo ha accesso alle conoscenze della posta elettronica dopo aver ricaricato la pagina.

Screenshot che mostra una risposta dell'agente dichiarativo che contiene le informazioni sulla posta elettronica

Aggiungere un connettore Copilot all'agente

L'aggiunta di un connettore Copilot rende disponibili all'agente gli elementi acquisiti da tale connettore come origine delle informazioni.

  1. Aprire il appPackage/declarativeAgent.json file e aggiungere il valore seguente alla matrice, sostituendolo policieslocal con un ID connettore Copilot valido nell'organizzazione capabilities di Microsoft 365. Per altre informazioni su come trovare gli ID connettore Copilot, vedere Recuperare gli ID funzionalità per il manifesto dell'agente dichiarativo.

    {
      "name": "GraphConnectors",
      "connections": [
        {
          "connection_id": "policieslocal"
        }
      ]
    }
    

    Per altre informazioni, vedere Oggetto connettori Copilot.

    Nota

    • Se non si specifica la matrice, tutto il connections contenuto dei connettori Copilot nell'organizzazione Microsoft 365 disponibile per l'utente connesso sarà disponibile per l'agente.
  2. Seleziona Provisioning nel pannello Ciclo di vita di Agents Toolkit.

L'agente dichiarativo ha accesso al contenuto dei connettori Copilot per generare le risposte dopo aver ricaricato la pagina.

Screenshot che mostra una risposta dell'agente dichiarativo che contiene il contenuto del connettore Copilot

Passaggio successivo