Migrating from ACE Agent 4.0.0 to ACE Agent 4.1.0#

If you plan to port your bot from ACE Agent 4.0.0 to ACE Agent 4.1.0, perform the following steps:

  1. ACE Agent 4.0.0 release supported Colang 1.0 and Colang 2.0-alpha versions, however, ACE Agent 4.1.0 supports Colang 1.0 and Colang 2.0-beta versions. We highly recommend switching to Colang 2.0-beta syntax as Colang 1.0 will be deprecated in future releases. Refer to the Colang Migration Guide to switch to Colang 2.0-beta syntax from other versions. Refer to Colang documentation for breaking changes from Colang 2.0-alpha to the 2.0-beta version.

  2. By default, we have switched to ACE Agent Event Architecture for scripts, most sample bots, and tutorials. If you are planning to use ACE Agent Server or Plugin Architecture, ensure you perform the following steps:

    1. Set PIPELINE to speech_lite in deploy/docker/docker_init.sh or UCS app-params.yaml.

    2. Disable the Colang Async execution in bot_config.yaml under the configs section.

      configs:
 use_stateful_guardrails: True
 colang_disable_async_execution: True

    3. If using UCS applications, make sure to set the server interface for the chat-engine component in app-params.yaml.

      chat-engine:
 interface: event

    4. Similarly, update the Chat Controller pipeline to UMIM-based pipelines, such as, speech_umim and avatar_umim.

      chat-controller:
 pipeline: speech_umim