Condividi tramite

Informazioni di riferimento sul comando dell'interfaccia della riga di comando di Agent 365 create-instance

Importante

È necessario far parte del programma di anteprima Frontier per ottenere l'accesso early a Microsoft Agent 365. Frontier ti connette direttamente con le ultime innovazioni di intelligenza artificiale di Microsoft. Le anteprime Frontier sono soggette ai termini di anteprima esistenti dei tuoi accordi con il cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la loro disponibilità e capacità potrebbero cambiare nel tempo.

Creare l'identità dell'agente e l'utente dell'agente e aggiungere autorizzazioni all'identità e alle licenze all'utente. Il create-instance comando crea istanze dell'agente con identità, licenze e autorizzazioni necessarie. Usare questo comando per configurare le istanze complete dell'agente, inclusa la creazione dell'identità dell'agente, l'assegnazione delle licenze necessarie e la concessione delle autorizzazioni all'identità.

Il create-instance comando esegue queste operazioni:

  1. Crea l'identità dell'agente: registra un'entità servizio identità agente in Microsoft Entra tramite il API Graph.
  2. Crea l'utente agente : crea un account utente agente associato all'identità.
  3. Assegna manager e sponsor : imposta l'utente corrente come responsabile e sponsor dell'utente e dell'identità dell'agente.
  4. Assegna licenze : assegna le licenze di Agent 365 necessarie all'utente dell'agente.

Ruolo minimo obbligatorio: Amministratore globale

Annotazioni

Se non si hanno ancora le licenze di Agent 365 necessarie da assegnare, è possibile continuare a usare create-instance identity e quindi usare create-instance licenses in seguito per assegnare le licenze quando sono disponibili.

Sintassi

Di seguito viene illustrata la sintassi per il create-instance comando e i relativi sottocomandi facoltativi.

a365 create-instance [command] [options]

Quando si esegue senza un sottocomando, vengono eseguiti create-instance entrambi i passaggi in sequenza: crea l'identità dell'agente e l'utente dell'agente, quindi assegna le licenze.

Options

Usare queste opzioni con il create-instance comando o i create-instance identity sottocomandi e create-instance licenses .

Opzione Description
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
-v, --verbose Mostra output dettagliato
--dry-run Mostra cosa sarebbe stato fatto senza eseguire
-?, -h, --help Visualizzare informazioni sulla Guida e sull'utilizzo

Prerequisiti

Prima di eseguire create-instance, assicurarsi di:

  • Completato il passaggio del progetto Dell'agente di installazione (a365 setup).
  • Pubblicare l'agente usando a365 publish.
  • Disporre di un valore valido a365.config.json e a365.generated.config.json nella directory di lavoro.
  • Accesso con un account con autorizzazioni di amministratore globale.

create-instance esempi

Questi esempi illustrano come usare il create-instance comando senza sottocomandi.

Creare un'istanza completa dell'agente

Eseguire create-instance senza opzioni per creare un'istanza completa dell'agente usando la configurazione predefinita.

a365 create-instance

Creare con un file di configurazione specifico

Usare l'opzione --config per specificare un percorso di file di configurazione personalizzato.

a365 create-instance --config path/to/a365.config.json

Visualizzare in anteprima le modifiche

Usare l'opzione --dry-run per vedere cosa create-instance fare senza apportare modifiche.

a365 create-instance --dry-run

create-instance identity

Creare l'identità dell'agente e l'utente dell'agente, ma non assegnare licenze.

Usare questo comando per ignorare le licenze durante la creazione di un'identità.

Annotazioni

Se non si dispone ancora di licenze disponibili, usare questo comando in modo che non venga bloccato. È possibile eseguire create-instance licenses quando si dispone di licenze.

a365 create-instance identity

create-instance licenses

Aggiungere licenze a un utente agente esistente.

Usare questo comando per creare le licenze quando l'identità esiste già.

Annotazioni

Se è stato usato create-instance identity in precedenza, usare questo comando quando sono disponibili le licenze.

a365 create-instance licenses

Usare questi comandi insieme create-instance a per gestire il ciclo di vita completo dell'agente.

  • Last updated on