Aller au contenu

Mettre à jour Tock

Cette page décrit comment mettre à jour une plateforme Tock et les bots qui l'utilisent vers une nouvelle version, et liste les changements qui demandent une action.

Procédure

  1. Lisez le changelog et les notes de version GitHub de toutes les versions entre votre version actuelle et la version cible, ainsi que les notes par version ci-dessous.
  2. Sauvegardez les bases MongoDB, par exemple avec mongodump, et la base vectorielle si vous utilisez le RAG.
  3. Mettez à jour tous les composants de la plateforme vers la même version : bot_admin, nlp_api, build_worker, bot_api, kotlin_compiler, duckling_bot, et l'orchestrateur Gen AI. Avec les descripteurs tock-docker, donnez la nouvelle version à la variable TAG.
  4. Mettez à jour les dépendances Tock de vos bots vers la même version (voir Bot intégré et Bot API).
  5. Redémarrez les composants, puis vérifiez leurs lignes de vie et les logs.
  6. Dans Tock Studio, vérifiez les réponses du bot dans Test > Test, et les constructions de modèles dans Model Quality > Model Builds.

Les composants et les bots d'une plateforme doivent utiliser la même version : mélanger les versions n'est pas pris en charge.

Les index MongoDB, et les éventuelles migrations de données, sont appliqués par les composants au démarrage : aucun script de migration n'est à exécuter, sauf mention contraire dans les notes par version.

Notes par version

26.9.1

Connecteurs retirés. Les connecteurs Alexa (connector-alexa), Google Assistant (connector-ga), Twitter (connector-twitter), Apple Business Chat (connector-businesschat) et Rocket.Chat (connector-rocketchat), dont les plateformes ont fermé ou ne sont plus utilisées, ne sont plus fournis. Supprimez leurs configurations dans Settings > Configurations, et leurs dépendances de vos bots.

Module retiré. Le module d'analytics Chatbase (tock-analytics-chatbase), dont le service a fermé, n'est plus fourni : supprimez sa dépendance de vos bots.

Propriété renommée. Le délai maximal des appels à l'API Bot Framework du connecteur Teams est désormais défini par tock_teams_request_timeout_ms. L'ancienne propriété tock_whatsapp_request_timeout_ms est encore lue si la nouvelle n'est pas définie.

Option retirée. L'option Alexa Export des options avancées de l'application a été retirée de Tock Studio.

26.9.0

Java 21. Tock est désormais construit pour Java 21 : les bots et la plateforme nécessitent un environnement d'exécution Java 21 (ou plus récent), et les bots Kotlin doivent cibler la JVM 21 (kotlin.compiler.jvmTarget).

Bill of materials. Le nouvel artefact tock-bom aligne les versions des dépendances Tock dans vos bots (voir Aligner les versions des dépendances).

26.3.0

Les réponses du RAG doivent être un objet JSON structuré. Le prompt Question answering de chaque bot, dans Gen AI > Rag settings, doit être mis à jour avant de déployer cette version, sans quoi le bot ne peut plus répondre avec le RAG. Voir la documentation du prompt RAG, qui décrit la sortie JSON attendue et fournit des exemples de prompts.

25.10.0

Le client Kotlin du mode Bot API utilise les coroutines. Les fonctions send et end de ClientBus sont désormais des fonctions suspend : le code qui les appelle en dehors d'un handler de story doit être adapté.

Chat with Tock
×