Exemplo 3 – Usar o Bing Search como fallback no Microsoft Copilot Studio

Artigo
04/02/2024

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

Observação

Agora o Microsoft Copilot Studio oferece suporte estes recursos sem o Composer.

Aprimore seu bot desenvolvendo diálogos personalizados com o Bot Framework Composer e, em seguida, adicione-os ao seu bot do Microsoft Copilot Studio.

Neste exemplo, você aprenderá como definir a pesquisa do Bing como uma resposta de fallback no Microsoft Copilot Studio usando o Composer.

Importante

A integração do Composer não está disponível para usuários que têm somente a licença do Teams do Microsoft Copilot Studio. É necessário ter uma licença de avaliação ou integral do Microsoft Copilot Studio.

Pré-requisitos

Criar um gatilho de fallback

No Microsoft Copilot Studio, abra o bot do Exemplo 2. Se você ainda não concluiu o Exemplo 2, consulte Exibir uma lista de opções de seleção múltipla no Microsoft Copilot Studio.
Abra seu bot no Composer. Para obter instruções sobre como fazer isso, consulte Introdução ao Bot Framework Composer.
No Bot explorer, vá até o diálogo principal. Selecione Mais opções (...) e, depois, Adicionar novo gatilho.
Na janela Criar um gatilho, em Qual é o tipo deste gatilho?, selecione Intenção desconhecida. Selecione Enviar.
Acesse a página Respostas de Bot, selecione Serviço de Entrega de Refeições da Contoso e selecione Mostrar código.

Copie e cole o seguinte trecho na exibição de código:

# adaptivecardjson_BingSearch(user_utterance)
- ```
{    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "type": "AdaptiveCard",
    "version": "1.2",
    "fallbackText": "This card requires Media to be viewed. Ask your platform to update to Adaptive Cards v1.1 for this and more!",
    "actions": [
        {
            "type": "Action.OpenUrl",
            "title": "Search with Bing",
            "url": "https://www.bing.com/search?q=${user_utterance}",
            "style": "positive"
        }
    ],
    "body": [
        {
            "type": "Image",
            "url": "https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RWe65Z?ver=2d4e&q=90&m=6&h=201&w=358&b=%23FFFFFFFF&l=f&o=t&aim=true"
        },
        {
            "type": "TextBlock",
            "text": "${user_utterance}",
            "wrap": true,
            "separator": true,
            "horizontalAlignment": "Center",
            "size": "Medium"

        }
    ]
}
```

Captura de tela do Cartão Adaptativo JSON adicionado às respostas do bot.

Copie e cole o seguinte código na mesma exibição de código:

# AdaptiveCardBingSearch(user_utterance)
[Activity
    Attachments = ${json(adaptivecardjson_BingSearch(user_utterance))}
]

Captura de tela da atividade adicionada às respostas do bot.

Acesse a página Criar. No diálogo principal, selecione o gatilho Intenção desconhecida.
Na tela de criação, selecione Adicionar (+) e, depois, Enviar uma resposta.
No painel de propriedades, na seção Respostas de bot, selecione Mostrar código.

Aviso

Adicionando a expressão da próxima etapa ao editor de resposta em vez do editor de código resultará no bot respondendo com um JSON bruto em vez de um Cartão Adaptável.

Copie e cole a seguinte expressão:

- ${AdaptiveCardBingSearch(turn.activity.text)}

Captura de tela da resposta para a ação Enviar uma resposta.

Testar o bot

Publicar seu conteúdo do Composerpara disponibilizá-lo em seu bot do Microsoft Copilot Studio.

Importante

Selecionar Publicar no Composer torna as mudanças disponíveis para teste, mas não publica automaticamente o seu bot.

Publique seu bot no Microsoft Copilot Studio para atualizá-lo em todos os canais aos quais ele está conectado.
Vá até a página Tópicos do Microsoft Copilot Studio para ver o novo conteúdo do tópico OnUnknownIntent.
Abra o painel Bot de teste e verifique se Rastrear entre tópicos está ativado. Insira a mensagem Is tofu vegan? para iniciar sua conversa.

Próximas etapas

Exemplo 4 – Exibir um formulário com um botão Enviar no Microsoft Copilot Studio.

Compartilhar via