Você pode usar ferramentas de widget para criar elementos de interface do usuário interativos e UI de maneira flexível. Ao configurar essa ferramenta, você fornece um tipo (carrossel, comparação etc.) e informações sobre o esquema do widget. Ao responder a consultas, o agente pode decidir usar essa ferramenta e configuração para enviar dados de widget de volta ao cliente. Em seguida, o cliente processa esses dados e apresenta o widget na interface do usuário. Quando o usuário faz uma seleção, você envia essas informações de volta ao agente.
Configuração
As seguintes configurações estão disponíveis:
- Nome:um nome exclusivo para a ferramenta (obrigatório).
- Descrição:uma descrição do que a ferramenta faz (opcional). Isso ajuda o modelo de linguagem do agente a entender quando usar essa ferramenta e como preencher os dados.
- Tipo de widget:o tipo específico de widget de conteúdo avançado que essa ferramenta representa.
Isso determina a estrutura esperada do payload e
como o cliente deve renderizá-lo.
Os tipos são:
- PRODUCT_CAROUSEL: mostra um carrossel rolável de produtos.
- PRODUCT_DETAILS: mostra informações detalhadas sobre um único produto.
- QUICK_ACTIONS: apresenta uma lista de botões de resposta sugeridos ou ações que o usuário pode realizar.
- PRODUCT_COMPARISON: mostra uma comparação lado a lado de vários produtos.
- ORDER_SUMMARY: mostra um resumo de um pedido.
- Parâmetros:o esquema de entrada para os dados do widget. O agente usa o esquema ao invocar a ferramenta. Isso é definido usando um objeto de esquema, especificando os campos e tipos de dados esperados para o conteúdo do widget.
Exemplos de descrições de ferramentas
Confira alguns exemplos de descrições de ferramentas eficazes:
| Tipo de widget | Exemplo de descrição da ferramenta |
|---|---|
| Carrossel de produtos | Gera um componente de carrossel da UI. Obrigatório sempre que o usuário pede para ver opções ou um catálogo. Você precisa fornecer a lista de produtos em productDetails, e o sistema vai renderizar automaticamente o card visual. |
| Detalhes do produto | Essa ferramenta deve ser chamada depois que você recebe as informações de um produto e tenta mostrá-lo ao usuário. |
| Ação rápida | Essa ferramenta deve ser chamada sempre que o usuário for perguntado se ele é uma empresa, escola ou organização sem fins lucrativos. Inclua exatamente três ações rápidas que digam "Sou uma empresa", "Sou uma escola" e "Sou uma organização sem fins lucrativos". |
| Comparação de produtos | Essa ferramenta deve ser invocada quando você precisar comparar dois produtos. |
| Resumo do pedido | Use essa ferramenta quando um usuário estiver pronto para concluir uma compra. Ele gera um resumo visual estruturado do item, detalhamento de preços (incluindo tributos e frete) e a forma de pagamento registrada. Chame essa ferramenta somente depois que o usuário confirmar que quer prosseguir para a fase de finalização da compra. |