Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Você pode ter agentes em sua organização que você criou usando C#, JavaScript ou Python e que estão hospedados no Azure ou em outra infraestrutura de hospedagem. Esses agentes são experiências especializadas que podem se concentrar em uma área específica, utilizar serviços de IA e já estão integradas a aplicativos da Web ou personalizados. Você pode usar o Kit de Ferramentas de Agentes do Microsoft 365 para exibir seu agente no Microsoft 365 Copilot Chat. Isso permite que os usuários usem a interface do usuário unificada do Microsoft 365 Copilot para trabalhar com agentes criados em toda a empresa, tornando seus agentes mais detectáveis e acessíveis aos usuários.
Usar o SDK de Agentes do Microsoft 365
Para trazer seu agente para o Microsoft 365 Copilot, use o Kit de Ferramentas de Agentes do Microsoft 365 para integrar o agente ao SDK de Agentes do Microsoft 365. O SDK do Agents dá suporte a C#, JavaScript e Python. Se o seu agente estiver escrito em um desses idiomas, você não precisará modificá-lo significativamente. Você pode simplesmente adicionar o código do SDK do Agents ao seu agente e usar os adaptadores de canal internos para implantar seu agente no Microsoft 365 Copilot.
Os adaptadores de canal integrados no SDK de Agentes do Microsoft 365 são compatíveis com vários canais, incluindo o Microsoft 365 Copilot. Ao encapsular seu agente existente com o SDK do Agents, você pode se integrar ao Azure Serviço de Bot que fica entre uma superfície ou canal do usuário, como Microsoft 365 Copilot, e seu código. O Azure Serviço de Bot traduz o que esse canal envia e o transforma em atividades comuns para corresponder ao que seu código entende - nesse caso, o wrapper do SDK do Agents que aceita mensagens recebidas de Azure Serviço de Bot.
Modificar componentes do seu agente
Para trazer seu agente para o Copilot, você precisa modificar alguns componentes do seu agente, conforme descrito nesta seção.
Recomendamos que você comece com o Kit de Ferramentas de Agentes do Microsoft 365 e use o exemplo de Eco/Agente Vazio (atualmente disponível em C# no Visual Studio e JavaScript no Visual Studio Code). Para se familiarizar com a estrutura do SDK do Agents, siga as etapas para testar e implantar seu agente usando o Agents Toolkit e o SDK; Essas ferramentas simplificam as tarefas descritas.
Criar o registro do aplicativo e Azure Serviço de Bot registro para lidar com a comunicação do canal - O SDK de Agentes do Microsoft 365 usa Azure Serviço de Bot para lidar com a comunicação entre canais e seu código, gerenciando componentes relacionados a esses canais. Você precisa Criar um recurso Azure Serviço de Bot com um registro de aplicativo que você referencia manualmente em seu agente.
Configurar os ouvintes de eventos do agente - Um agente criado com o SDK de Agentes do Microsoft 365 é estruturado para ouvir eventos do canal - neste caso, o Microsoft 365 Copilot. Para começar, use OnActivity.
Atualize a estrutura do seu agente para que ele possa lidar com a atividade enviada do Microsoft 365 Copilot para o Azure Serviço de Bot. Para fazer isso, adicione o agente existente à estrutura de um agente criado com SDK de Agentes do Microsoft 365. Você não precisa mencionar especificamente muitas atividades; um agente pode escutar qualquer mensagem do cliente usando o método OnActivity. O agente existente pode ser adicionado ou referenciado no método que é acionado a partir do evento que está sendo escutado e, portanto, executado sempre que uma atividade for enviada. Uma atividade pode ser uma mensagem ou outro tipo de ação dentro do canal.
Crie manualmente ou gere um arquivo de manifesto usando o Kit de Ferramentas de Agentes. Microsoft 365 Copilot requer um pacote .zip que contenha um arquivo de manifesto. O arquivo de manifesto inclui um conjunto de instruções para informar ao Microsoft 365 Copilot onde procurar seu agente e outras informações. O Microsoft 365 Copilot requer que um agente esteja hospedado e um ponto de extremidade vinculado por meio de um registro de aplicativo (ID) e referenciado em um arquivo de manifesto. Se o seu agente for executado no Teams, você poderá modificar o arquivo de manifesto existente para dar suporte ao esquema mais recente do Microsoft 365 Copilot.
Os agentes conectados ao Microsoft 365 Copilot podem, opcionalmente, solicitar permissão do usuário para agir em seu nome. Se você optar por usar esse recurso, configure-o durante o processo de configuração do agente no Azure Serviço de Bot. Ferramentas para começar
O esforço necessário para trazer seu agente para o Copilot varia de acordo com a complexidade do agente e se você precisa adicionar gerenciamento de token para permitir que seu agente use a identidade do usuário para definir o escopo de seu conhecimento.
Para começar, use o Microsoft 365 Agents Toolkit e o exemplo Echo Agent para criar seu agente e siga a documentação do Visual Studio ou do Visual Studio Code para testá-lo e implantá-lo. Isso ajudará você a se familiarizar com a forma como o Agents Toolkit, o SDK do Agents e o Microsoft 365 Copilot funcionam juntos.