Compartilhar via

Referência de comando da CLI create-instance do Agent 365

Importante

Você precisa fazer parte do programa de visualização Frontier para obter acesso ararly ao agente Microsoft 365. A Frontier conecta você diretamente com as inovações de IA mais recentes da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Crie a Identidade do Agente e o Usuário do Agente e adicione permissões à identidade e licenças ao usuário. O create-instance comando cria instâncias de agente com identidades, licenças e permissões necessárias. Use este comando para configurar instâncias de agente completas, incluindo a criação da identidade do agente, a atribuição de licenças necessárias e a concessão de permissões à identidade.

O create-instance comando executa estas operações:

  1. Creates Agent Identity - registra uma entidade de serviço de identidade do agente em Microsoft Entra por meio do API do Graph.
  2. Cria o Usuário do Agente – Cria uma conta de usuário do agente associada à identidade.
  3. Atribui o gerente e o patrocinador – Define o usuário atual como gerente e patrocinador do usuário e da identidade do agente.
  4. Atribui licenças – atribui as licenças necessárias do Agente 365 ao usuário do agente.

Função mínima necessária: Administrador Global

Observação

Se você ainda não tiver as licenças necessárias do Agente 365 para atribuir, poderá continuar usando create-instance identity e depois usar create-instance licenses para atribuir as licenças quando as tiver.

Sintaxe

O seguinte mostra a sintaxe do create-instance comando e seus subcomandos opcionais.

a365 create-instance [command] [options]

Quando você executa create-instance sem um subcomando, ele executa as duas etapas em sequência: ele cria a identidade do agente e o usuário do agente e atribui licenças.

Opções

Use essas opções com o create-instance comando ou os create-instance licensescreate-instance identity subcomandos.

Opção Description
-c, --config <config> Caminho do arquivo de configuração (padrão: a365.config.json)
-v, --verbose Mostrar saída detalhada
--dry-run Mostrar o que seria feito sem executar
-?, , -h--help Mostrar informações de ajuda e utilização

Pré-requisitos

Antes de executar create-instance, verifique se você:

  • Concluída a etapa de blueprint do agente de instalação (a365 setup).
  • Publicou seu agente usando a365 publish.
  • Tenha um diretório válido a365.config.json e a365.generated.config.json em seu diretório de trabalho.
  • Conectado com uma conta que tem permissões de Administrador Global.

create-instance Exemplos

Esses exemplos mostram como usar o create-instance comando sem subcomandos.

Criar uma instância de agente completa

Execute create-instance sem opções para criar uma instância de agente completa usando a configuração padrão.

a365 create-instance

Criar com um arquivo de configuração específico

Use a opção --config para especificar um caminho de arquivo de configuração personalizado.

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

Visualizar as alterações

Use a opção --dry-run para ver o que create-instance faria sem fazer nenhuma alteração.

a365 create-instance --dry-run

create-instance identity

Crie a identidade do agente e o usuário do agente, mas não atribua licenças.

Use este comando para ignorar as licenças durante a criação de uma identidade.

Observação

Se você ainda não tiver licenças disponíveis, use esse comando para não ser bloqueado. Você pode executar create-instance licenses quando tiver licenças.

a365 create-instance identity

create-instance licenses

Adicione licenças a um usuário do agente existente.

Use este comando para criar as licenças quando a identidade já existir.

Observação

Se você usou create-instance identity anteriormente, use esse comando quando as licenças estiverem disponíveis.

a365 create-instance licenses

Use esses comandos para create-instance gerenciar todo o ciclo de vida do agente.

  • Last updated on