Partilhar via

Referência de comando CLI create-instance do Agente 365

Importante

Precisa de fazer parte do programa de pré-visualização Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier liga-o diretamente às mais recentes inovações de IA da Microsoft. As pré-visualizações da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como estas funcionalidades ainda estão em desenvolvimento, a sua disponibilidade e capacidades podem mudar ao longo do tempo.

Crie Identidade de Agente e Utilizador Agente, e adicione permissões à identidade e licenças ao utilizador. 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 completas do agente, incluindo a criação da identidade do agente, atribuição das licenças necessárias e concessão de permissões à identidade.

O create-instance comando executa as seguintes operações:

  1. Cria Identidade de Agente - Regista um principal de serviço de identidade de agente em Microsoft Entra através do Graph API.
  2. Cria Utilizador Agente - Cria uma conta de utilizador agente associada à identidade.
  3. Atribui gestor e patrocinador - Define o utilizador atual como gestor e patrocinador do utilizador agente e da identidade.
  4. Atribui licenças - Atribui as licenças necessárias do Agente 365 ao utilizador do agente.

Função mínima exigida: Administrador Global

Observação

Se ainda não tiver as licenças Agent 365 necessárias para ceder, pode continuar a usar create-instance identity e create-instance licenses depois usar para atribuir as licenças quando as tiver.

Sintaxe

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

a365 create-instance [command] [options]

Quando executas create-instance sem subcomando, executa ambos os passos em sequência: cria a identidade do agente e o utilizador do agente, depois atribui licenças.

Opções

Use estas opções com o create-instance comando ou os create-instance identity subcomandos e.create-instance licenses

Opção Description
-c, --config <config> Caminho do ficheiro de configuração (padrão: a365.config.json)
-v, --verbose Mostrar resultados detalhados
--dry-run Mostra o que seria feito sem executar
-?, -h, --help Mostrar ajuda e informação de utilização

Pré-requisitos

Antes de correr create-instance, certifique-se de:

  • Concluí o passo do blueprint do agente de Configuração (a365 setup).
  • Publicou o seu agente usando a365 publish.
  • Tem um diretório válido a365.config.json e a365.generated.config.json no teu diretório de trabalho.
  • Iniciei sessão com uma conta que tem permissões de Administrador Global.

create-instance exemplos

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

Crie uma instância de agente completa

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

a365 create-instance

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

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

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

Pré-visualize as alterações

Use a --dry-run opção para ver o que create-instance acontece sem fazer alterações.

a365 create-instance --dry-run

create-instance identity

Crie Identidade de Agente e Utilizador de Agente, mas não atribua licenças.

Use este comando para saltar as licenças enquanto cria uma identidade.

Observação

Se ainda não tens licenças disponíveis, usa este comando para não ficares bloqueado. Podes correr create-instance licenses quando tiveres licenças.

a365 create-instance identity

create-instance licenses

Adicione licenças a um Utilizador Agente existente.

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

Observação

Se usou create-instance identity anteriormente, use este comando quando houver licenças disponíveis.

a365 create-instance licenses

Use estes comandos em conjunto create-instance para gerir todo o ciclo de vida do seu agente.

  • Last updated on