Eseguire l'integrazione con le app native usando Agents Client SDK

Important

Questo contenuto è destinato a professionisti IT esperti, ad esempio amministratori IT o sviluppatori, che hanno familiarità con strumenti di sviluppo, utilità e ambienti di sviluppo integrati (IDE). La creazione di questa integrazione richiede competenze di sviluppo software.

Agents Client SDK è un SDK per piattaforme Android, iOS e Windows. Questo SDK consente di comunicare con gli agenti sviluppati con Copilot Studio o Managed Disks, da app native per Android, iOS e Windows.

Con l'SDK Agents Client, stiamo introducendo la multimodalità nell'interazione con l'agente utente. Gli utenti possono ora comunicare con gli agenti tramite testo o voce, condividendo il contesto tramite immagini o acquisizioni dello schermo.

La prima versione dell'SDK supporta il rendering di schede adattive e comunicazioni basate su testo per utenti finali non autenticati o anonimi con agenti creati in Copilot Studio. È possibile aggiungere schede adattive agli argomenti usando l'opzione Chiedi con scheda adattiva .

Important

Attualmente l'SDK supporta solo gli utenti non autenticati e può essere usato nelle app native se si ritiene appropriato tale utilizzo e necessario per gli utenti finali.

Configurare l'agente per le applicazioni native

  1. Vai al tuo agente in Copilot Studio selezionando Agenti e quindi il tuo agente.

  2. In Impostazioni>Autenticazione di sicurezza> selezionare Nessuna autenticazione.

    Screenshot dell'impostazione di sicurezza No Authentication abilitata per un agente in Copilot Studio.

  3. Vai alla pagina Canali per il tuo agente.

    Con l'opzione Nessuna autenticazione selezionata, è consigliabile esaminare.

    Screenshot della pagina Canali per l'agente che mostra la revisione consigliata a causa della mancata selezione dell'autenticazione.

  4. Selezionare Pubblica

    Viene visualizzata la schermata Pubblica questo agente .

    Screenshot della schermata di conferma della pubblicazione per l'agente in Copilot Studio.

  5. Selezionare Pubblica L'agente è pubblicato e disponibile per l'uso con il client SDK.

Ottenere le informazioni necessarie per l'integrazione con l'SDK

Prima di aggiungere l'integrazione per l'agente nel codice dell'app, sono necessari alcuni dettagli da Copilot Studio sull'agente.

  1. Vai al tuo agente in Copilot Studio selezionando Agenti e quindi selezionando il tuo agente.

  2. Passare a Impostazioni>Impostazioni avanzate>Metadati.

    Prendi nota di ID ambiente e Nome schema.

    Screenshot della pagina Impostazioni avanzate che mostra environmentID e nome dello schema per l'agente.

  3. Prendi nota dell'ambiente di distribuzione per il tuo agente. Per copilotstudio.microsoft.com e copilotstudio.preview.microsoft.com, l'ambiente di distribuzione è prod. Per copilotstudio.preprod.microsoft.com, l'ambiente di distribuzione è preprod.

Altre informazioni su Agents Client SDK

Usando quindi le informazioni raccolte, è possibile integrare l'agente nel codice dell'app nativa usando Agents Client SDK.

Per il codice e altre informazioni su come integrare l'agente nell'app nativa, vedere il repository GitHub per la piattaforma di app preferita:

  • Last updated on