...
A execução de código customizado dentro dos nós de intenção (fulfillments) que são executados dentro do processamento das conversas será desativado e descontinuado. A execução de código customizado com os dados da sessão da conversa somente será possível com a configuração de webhooks.
Com esta mudança, além da melhoria da segurança da plataforma TOTVS Carol Assistente e de sua performance, incentivamos ainda mais a liberdade de escolha de ferramentas, tecnologias e frameworks para as soluções, uma vez que os "fulfillments" embutidos são limitados a serem desenvolvidos em Python, em um ambiente fechado e sem liberdade de configuração ou instalação de bibliotecas.
Durante a primeira fase de desativação, os ambientes que já possuem os fulfillments embutidos habilitados continuarão funcionando normalmente, mas, novos fulfillments somente poderão ser criados usando webhooks. Na segunda fase da desativação todos os fulfillments embutidos serão colocados em modo de somente leitura, não podendo ser mais alterados, mas a execução e funcionamento do "fulfillment" será mantida. E na terceira e última fase da desativação, a execução e acesso de todos os "fulfillments" embutidos será desativados.
...
Data | Fase de Desativação | Observações |
---|---|---|
dd/mm/aaaa | Fase 1 - Desativação de novos fulfillments | Fulfillments já criados continuaram funcionando normalmente, novos fulfillments só poderão ser criados no modo webhook |
dd/mm/aaaa | Fase 2 - Todos os fulfillments embutidos em modo somente leitura | Fulfillments já criados não poderão ser mais editados ou salvos. Importante: mas a execução do código customizado ainda continuará ser realizada. Novos fulfillments só poderão ser criados no modo webhook |
dd/mm/aaaa | Fase 3 - Desativação total de fulfillments embutidos | O acesso e execução de todos os fulfillments embutidos será desativado. Os nós de intenção que ainda tiverem um fulfillment embutido associado, terá sua configuração de fulfillment serão reiniciados ao seu estado original e o código customizado será descartado. Todos os fulfillments que foram migrados para a configuração webhook, não serão afetados. |
...
Para executar um código customizado no TOTVS Carol Assistente será necessário a configuração de um WebHook no nó de intenção. Para maiores informações do funcionamento do webhook, veja a como fazer isso documentação do TOTVS Carol Assistente.
...
A principal vantagem de usar WebHooks para execução de código customizado, é que agora os desenvovedores desenvolvedores não ficaram limitados somente a liguagem linguagem Python da versão implementada, qualquer tecnologia que possa receber uma chamada HTTP poderá ser utilizada para interagir com o TOTVS Carol Assisntente Assistente e com o cliente.
Para facilitar o processo de migração do código fonte dos fulfillments embutidos para o modo webhook, disponibilizamos uma biblioteca Python para isso, https://pypi.org/project/assistant-fulfillment-helper/. Basta seguir os exemplos da documentação da biblioteca para migrar o código com o mínimo de alterações necessárias.
...