Usar habilidades do Azure Serviço de Bot em agentes do Copilot Studio

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

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:

  1. Vá até a página Tópicos do agente.

  2. Abra o tópico de onde você quer invocar uma habilidade.

  3. Selecione o ícone Adicionar nó no nó após o qual você deseja chamar a habilidade.

  4. Selecione Adicionar uma ferramenta e depois selecione a habilidade que deseja usar.

  5. 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.

  6. Selecione Salvar para persistir suas alterações no tópico.

  7. 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:

  1. Criar um novo registro de aplicativo Microsoft Entra ID de locatário único.

  2. Atualize a configuração de habilidade para usar o locatário único.

  3. Coloque a habilidade em prática.

  4. (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.