Use Azure Bot Service competências em agentes de Copilot Studio

Note

Este artigo descreve as funcionalidades usadas em agentes ou fluxos de agentes alimentados pelo arnês padrão.

Important

Este artigo inclui informações sobre Azure Bot Service skills, uma forma baseada em código para expandir as capacidades de um agente na estrutura padrão. Estas competências não devem ser confundidas com competências agentivas do GitHub Copilot. Saiba mais sobre como usar competências agentic na visão geral de Competências 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.

De seguida, regista a aptidão do Azure Bot Service no Copilot Studio para que o teu agente possa usá-la.

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

  1. Vai à página de Tópicos do agente.

  2. Abre o tópico de onde queres chamar uma competência.

  3. Seleciona o ícone Adicionar nó por baixo do nó, após o qual queres chamar a habilidade.

  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 competência 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 skill existente do Azure Bot Service de multitenant para single-tenant

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 da skill para usar 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.