Criar instâncias de agente

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA 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.

Depois de publicar seu agente e disponibilizá-lo no Microsoft Admin Center, você pode criar instâncias e usuários de agentes. Essas instâncias e usuários usam o blueprint do agente e o código do agente que você criou.

Pré-requisitos

• Blueprint do agente configurado corretamente conforme a etapa do Blueprint do agente de configuração.
• Aplicação agente publicada corretamente conforme o agente Publish no Microsoft Admin Center.

1. Configurar agente no Portal de Desenvolvedores do Teams

Após publicar, configure o blueprint do agente no Portal de Desenvolvedores do Teams para conectar seu agente à infraestrutura de mensagens do Microsoft 365. Sem essa configuração, seu agente não recebe mensagens do Teams, e-mail ou outros serviços do Microsoft 365.

Obtenha seu ID de planta

Execute o seguinte comando para exibir sua configuração:

a365 config display -g

Copie o agentBlueprintId valor da saída.

Navegar até o Portal de Desenvolvedores

Abra seu navegador e vá para a página de configuração:

https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

Substitua <your-blueprint-id> pelo agentBlueprintId valor que você copiou.

Observação

Se você não tiver acesso ao Portal do Desenvolvedor, entre em contato com o administrador do seu inquilino para conceder acesso ou completar essa configuração em seu nome.

Configurar o agente

No Portal do Desenvolvedor:

1. Defina o tipo de agente para baseado em bots
2. Defina o ID do Bot para seu agentBlueprintId valor
3. Selecione Salvar

Você precisa dessa configuração antes de poder criar instâncias de agente no Teams.

Saiba mais sobre Blueprints de Identidade de Agente e configuração do Portal de Desenvolvedores.

2. Criar instância de agente

Agora você pode solicitar uma instância do seu blueprint de agente pelo Teams. Saiba mais sobre como descobrir, criar e integrar um agente.

Quando você solicita uma instância de agente, o Teams envia a solicitação para o administrador do seu tenant para aprovação. Administradores podem revisar e aprovar solicitações na página de Agentes Solicitados do Microsoft Admin Center .

Depois que o administrador aprova sua solicitação, o Teams cria sua instância de agente e a disponibiliza no Teams.

3. Teste seu agente destacado

Após criar uma instância agente, teste-a no Microsoft 365 para garantir que funciona corretamente em produção.

Após a implantação, e com as notificações do agente ativadas no SDK do Agente 365, seu agente se integra aos serviços do Microsoft 365. Ele funciona com o Teams para chats, canais e reuniões; com e-mail e calendário para envio, recebimento e agendamento; e com SharePoint e OneDrive para acesso a documentos e compartilhamento de arquivos. Também suporta recursos de colaboração, como presença organizacional, tarefas do Planner e comentários de documentos.

Importante

Assim como os usuários comuns, usuários de agentes também precisam de licenças apropriadas do Microsoft 365 para acessar os serviços. Licenças comuns incluem Microsoft 365 E5, Teams Enterprise e Microsoft 365 Copilot.

Visualizar agente implantado no Centro de Administração

Depois que você publica seu agente, ele aparece no Microsoft Admin Center para contratação. Pode levar algum tempo para se propagar.

Acesse o Centro de Administração do Microsoft 365 - Agentes para:

• Veja seu agente publicado
• Gerenciar configurações do aplicativo
• Monitorizar a utilização do agente
• Configurar permissões

Agente de testes no Teams

Após implantar, publicar e configurar seu blueprint de agente, além de criar um usuário agente, teste o usuário agente diretamente no Microsoft Teams:

Observação

Requisito da licença: Certifique-se de ter a licença "Microsoft Agent 365 Frontier" atribuída à sua conta. Essa licença é necessária para criar instâncias de agentes e interagir com agentes no Microsoft Teams enquanto o Agente 365 está em Prévia. Entre em contato com o administrador do seu inquilino se você não tiver essa licença.

1. Comece a testar

   • Procure pelo seu novo usuário agente no Teams. O processo de criação do usuário agente é assíncrono e pode levar de alguns minutos a algumas horas para o usuário agente se tornar pesquisável após a criação.
   • Comece um novo chat com sua instância de agente recém-criada.
   • Envie mensagens de teste para verificar a funcionalidade do agente.

2. Exemplo de mensagem de teste

   Se você configurou o agente com E-mail, envie esta mensagem para testar a funcionalidade do e-mail (atualize o e-mail do destinatário conforme necessário):

   Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"
   

   O agente processa a solicitação e envia o e-mail sem precisar de mais confirmação.

Próximas etapas

Parabéns! Seu agente agora está ao vivo na nuvem e pronto para trabalhar ao lado da sua equipe no Microsoft 365. O que começou como código local agora é um assistente pronto para empresas e descoberto, onde os usuários podem criar instâncias de agentes em toda a sua organização. O ciclo de desenvolvimento do seu agente está completo, mas seu impacto está apenas começando.

Grande parte do que você construiu no ciclo de vida do desenvolvedor do agente 365 é open source e recebe contribuições da comunidade. Levantar bugs, solicitações de recursos e pull requests:

• Amostras de Agente 365: Tem alguns agentes de amostra interessantes e divertidos? Compartilhe seu código de agente com a comunidade open source aqui!
• Node.js SDK: O SDK Agente 365 em Node.js
• SDK Python: O SDK Agent 365 em Python
• .NET SDK: O SDK do Agente 365 em C# (.NET)
• Agent 365 DevTools CLI: Uma CLI para ajudar você durante todo o ciclo de desenvolvimento do Agent 365