Utilizar as capacidades do Azure Bot Service em agentes do Copilot Studio

Note

Este artigo descreve as funcionalidades utilizadas em agentes ou fluxos de agentes com tecnologia do harness standard.

Important

Este artigo inclui informações sobre as capacidades do Azure Bot Service, uma forma baseada em código de expandir as funções de um agente no harness standard. Estas capacidades não devem ser confundidas com as capacidades por meio de agentes no harness do GitHub Copilot. Saiba mais sobre como utilizar as capacidades por meio de agentes em Descrição geral das capacidades para agentes.

Copilot Studio permite-te expandir o teu agente usando as Azure Bot Service competências. Se a sua organização já tem bots implementados para cenários específicos (construídos usando ferramentas pro-code, incluindo o SDK de Agentes do Microsoft 365), pode converter esses bots em competências Azure Bot Service e incorporá-los num agente Copilot Studio.

Prerequisites

Adicione uma skill do Azure Bot Service à conversa de um agente

Primeiro, crie um agente Copilot Studio e crie e implemente a skill do Azure Bot Service usando ferramentas pro-code na sua organização.

Em seguida, registe a capacidade do Azure Bot Service no Copilot Studio para que o seu agente possa utilizá-la.

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

  1. Aceda à página Tópicos do agente.

  2. Abra o tópico a partir do qual pretende chamar uma competência.

  3. Selecione o ícone Adicionar nó sob o nó após o qual pretende acionar a competência.

  4. Seleciona Adicionar uma ferramenta e depois seleciona a habilidade que queres usar.

  5. Se a sua competência tiver entradas, atribua-lhes variáveis. Além disso, se a sua capacidade gerar resultados em variáveis, poderá utilizar essas variáveis em quaisquer nós subsequentes.

    Note

    As skills do Azure Bot Service podem aceitar tipos de dados simples (inteiros, booleanos, string) e tipos de dados complexos (como cadeias JSON).

    Se precisar de extrair variáveis de tipos de dados complexos, tem de utilizar o fluxo de agente para análises futuras e decompor as cadeias JSON complexas em pares chave-valor para utilização no seu agente.

  6. Selecione Salvar para manter as alterações no tópico.

  7. Teste o seu agente para garantir que está a usar a habilidade corretamente.

Converter uma capacidade existente do Azure Bot Service de multi-inquilino para inquilino único

Pode converter skills existentes do Azure Bot Service de suporte multitenant para suporte single-tenant. Para converter uma competência multitenant numa competência single-tenant, faça as seguintes alterações:

  1. Crie um novo registo de aplicação Microsoft Entra ID de um único inquilino.

  2. Atualize a configuração de capacidades para utilizar um inquilino único.

  3. Utiliza a habilidade.

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

Saiba mais em Implementar uma habilidade Azure Bot Service para Copilot Studio.

skills do Azure Bot Service de tenant único e políticas de acesso condicional

Os administradores de tenant do Microsoft Entra ID podem configurar políticas de acesso condicional para controlar o acesso aos recursos no tenant. Estas políticas podem afetar os pedidos aos recursos, incluindo skills do Azure Bot Service, com base em fatores como a geografia. Reveja as políticas de acesso condicional do seu locatário.