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.
Note
Este artigo descreve recursos usados em agentes ou fluxos de agente com tecnologia do harness padrão.
Important
Este artigo inclui informações sobre habilidades do Serviço de Bot do Azure, uma maneira baseada em código de estender os recursos de um agente no agente padrão. Essas habilidades não devem ser confundidas com habilidades de agentes no agente do GitHub Copilot. Saiba mais sobre como usar habilidades agenticas na visão geral de Habilidades para agentes.
Copilot Studio permite que você expanda seu agente usando Azure Serviço de Bot habilidades. Se sua organização já possui bots implantados para cenários específicos (construídos usando ferramentas de pro-code, incluindo o SDK de Agentes do Microsoft 365), você pode converter esses bots em habilidades Azure Serviço de Bot e incorporá-los em um agente Copilot Studio.
Pré-requisitos
- Analise restrições e validações para habilidades do Azure Serviço de Bot usadas no Copilot Studio.
- A assinatura autônoma do Copilot Studio. Se você tem um Plano do Teams, você não pode usar habilidades de SDK de Agentes.
Adicione uma habilidade Azure Serviço de Bot à conversa de um agente
Primeiro, crie um agente Copilot Studio e crie e implante a habilidade Azure Serviço de Bot usando ferramentas pro-code na sua organização.
Em seguida, registre a habilidade Azure Serviço de Bot em Copilot Studio para que seu agente possa usá-la.
Por fim, adicione a habilidade Azure Serviço de Bot a um tema de conversa seguindo estes passos:
Vá até a página Tópicos do agente.
Abra o tópico de onde você quer invocar uma habilidade.
Selecione o ícone Adicionar nó
no nó após o qual você deseja chamar a habilidade.Selecione Adicionar uma ferramenta e depois selecione a habilidade que deseja usar.
Se sua habilidade tiver entradas, atribua variáveis a essas entradas. Além disso, se a habilidade for para variáveis, você poderá usá-las em qualquer nó a seguir.
Note
As habilidades do Azure Serviço de Bot podem aceitar tipos de dados simples (inteiro, booleano, string) e tipos de dados complexos (como strings JSON).
Se precisar extrair variáveis dos tipos de dados complexos, você deverá usar um fluxo do agente para analisar e dividir cadeias de caracteres JSON complexas em pares de valores-chave a serem usados no agente.
Selecione Salvar para persistir suas alterações no tópico.
Teste seu agente para garantir que ele está usando a habilidade corretamente.
Converter uma habilidade do Serviço de Bot do Azure existente de multilocatário para locatário único
Você pode converter habilidades de Azure Serviço de Bot existentes de suporte multitenant para suporte single-tenant. Para converter uma habilidade multilocatário em uma habilidade de locatário único, faça as seguintes alterações:
Criar um novo registro de aplicativo Microsoft Entra ID de locatário único.
Atualize a configuração de habilidade para usar o locatário único.
Coloque a habilidade em prática.
(Opcional) Atualize o código-fonte.
Saiba mais em Implementar uma habilidade Azure Serviço de Bot para Copilot Studio.
Habilidades do Azure Serviço de Bot de locatário único e políticas de acesso condicional
Microsoft Entra ID administradores de locatários podem configurar políticas de acesso condicional para controlar o acesso aos recursos no locatário. Essas políticas podem afetar solicitações para recursos, inclusive habilidades do Serviço de Bot do Azure, com base em fatores como a geografia. Revise as políticas de acesso condicional no locatário.