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

Note

Este artigo descreve recursos usados em agentes ou fluxos de agentes baseados no harness padrão.

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 à conversa de um agente

Primeiro, crie um agente do Copilot Studio e crie e implemente a habilidade usando ferramentas de código avançado em sua organização.

Em seguida, registre a habilidade no Copilot Studio para que o agente possa usá-la.

Por fim, adicione a habilidade a um tema de conversa seguindo estes passos:

  1. Vá para a página de Tópicos do agente.

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

  3. Selecione o ícone Adicionar nó abaixo do nó sob o qual você quer 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 gerar saídas para variáveis, você poderá usar essas variáveis em qualquer nó que siga.

    Note

    As habilidades podem aceitar tipos de dados simples (inteiro, booliano, cadeia de caracteres) e complexos (como cadeias de caracteres 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 um recurso existente de multilocatário para locatário único

Você pode converter as habilidades existentes do suporte a vários locatários em suporte a um único locatário. Para converter uma habilidade multilocatário em uma habilidade de inquilino único, faça as seguintes alterações:

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

  2. Atualize a configuração da habilidade para usar o modelo monousuário.

  3. Coloque a habilidade em prática.

  4. (Opcional) Atualize o código-fonte.

Para obter mais informações, consulte Implementar uma habilidade para o Copilot Studio.

Habilidades 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 as solicitações de recursos, incluindo habilidades, com base em fatores como geografia. Revise as políticas de acesso condicional do seu locatário.