Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Pode ter agentes na sua organização que criou com C#, JavaScript ou Python e que estão alojados no Azure ou noutra infraestrutura de alojamento. Estes agentes são experiências especializadas que podem estar focadas numa área específica que utilizam serviços de IA e já estão integrados na Web ou em aplicações personalizadas. Pode utilizar o Toolkit de Agentes do Microsoft 365 para apresentar o agente no Microsoft 365 Copilot Chat. Isto permite que os utilizadores utilizem a IU unificada do Microsoft 365 Copilot para trabalhar com agentes criados em toda a empresa, tornando os seus agentes mais detetáveis e acessíveis aos utilizadores.
Utilizar o SDK de Agentes do Microsoft 365
Para trazer o seu agente para o Microsoft 365 Copilot, utilize o Toolkit de Agentes do Microsoft 365 para integrar o agente no SDK de Agentes do Microsoft 365. O SDK de Agentes suporta C#, JavaScript e Python. Se o seu agente estiver escrito num destes idiomas, não tem de modificá-lo significativamente. Pode simplesmente adicionar o código SDK de Agentes ao agente e utilizar os adaptadores de canal incorporados para implementar o agente no Microsoft 365 Copilot.
Os adaptadores de canais incorporados no SDK de Agentes do Microsoft 365 suportam vários canais, incluindo o Microsoft 365 Copilot. Ao encapsular o agente existente com o SDK de Agentes, pode integrar com o Azure Serviço de Bot que se encontra entre uma superfície de utilizador ou um canal ( como o Microsoft 365 Copilot) e o seu código. O Azure Serviço de Bot traduz o que esse canal envia e transforma-o em atividades comuns para corresponder ao que o código compreende neste caso, o wrapper do SDK de Agentes que aceita mensagens recebidas do Azure Serviço de Bot.
Modificar componentes do agente
Para trazer o agente para o Copilot, tem de modificar alguns componentes do agente, conforme descrito nesta secção.
Recomendamos que comece com o Toolkit de Agentes do Microsoft 365 e utilize o exemplo de Agente Eco/Vazio (atualmente disponível em C# no Visual Studio e JavaScript no Visual Studio Code). Para se familiarizar com a estrutura do SDK de Agentes, siga os passos para testar e implementar o agente com o Toolkit de Agentes e o SDK; estas ferramentas simplificam as tarefas descritas.
Criar o registo de aplicações e o registo de Serviço de Bot do Azure para processar a comunicação de canais – o SDK de Agentes do Microsoft 365 utiliza o Azure Serviço de Bot para processar a comunicação entre canais e o seu código, gerindo componentes relacionados com esses canais. Tem de Criar um recurso do Azure Serviço de Bot com um registo de aplicação que referencia manualmente no seu agente.
Configure os serviços de escuta de eventos do agente – um agente criado com o SDK de Agentes do Microsoft 365 está estruturado para escutar eventos a partir do canal – neste caso, o Microsoft 365 Copilot. Para começar, utilize OnActivity.
Atualize a estrutura do seu agente para que possa processar a atividade enviada do Microsoft 365 Copilot para o Azure Serviço de Bot. Para tal, adicione o agente existente à estrutura de um agente criado com SDK de Agentes do Microsoft 365. Não tem de chamar especificamente muitas atividades; um agente pode escutar qualquer mensagem do cliente através do método OnActivity. Em seguida, o agente existente pode ser adicionado ou referenciado no método que é acionado a partir do evento que está a ser escutado e, portanto, executado sempre que uma atividade é enviada. Uma atividade pode ser uma mensagem ou outro tipo de ação no canal.
Crie manualmente ou gere um ficheiro de manifesto com o Toolkit de Agentes. O Microsoft 365 Copilot requer um pacote de .zip que contenha um ficheiro de manifesto. O ficheiro de manifesto inclui um conjunto de instruções para indicar ao Microsoft 365 Copilot onde procurar o agente e outras informações. O Microsoft 365 Copilot requer que um agente seja alojado e um ponto final ligado através de um registo de aplicação (ID) e referenciado num ficheiro de manifesto. Se o seu agente for executado no Teams, pode modificar o ficheiro de manifesto existente para suportar o esquema mais recente do Microsoft 365 Copilot.
Os agentes ligados ao Microsoft 365 Copilot podem, opcionalmente, pedir permissão ao utilizador para agir em seu nome. Se optar por utilizar esta capacidade, configure-a 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 o agente para o Copilot varia consoante a complexidade do agente e se precisa de adicionar a gestão de tokens para permitir que o agente utilize a identidade do utilizador para definir o âmbito dos respetivos conhecimentos.
Para começar, utilize o Toolkit de Agentes do Microsoft 365 e o exemplo do Agente Echo para criar o agente e siga a documentação do Visual Studio ou Visual Studio Code para testá-lo e implementá-lo. Isto irá ajudá-lo a familiarizar-se com a forma como o Toolkit de Agentes, o SDK de Agentes e o Microsoft 365 Copilot funcionam em conjunto.