Oracle Cloud Infrastructure Documentation

Task 3: Sign Your Digital Assistant into the Service

To sign a digital assistant into Oracle B2C Service or Oracle Fusion Service as a digital-assistant agent, create a DA as Agent channel and then enable it. This task also identifies the digital assistant to route the conversation to.

Each DA as Agent channel must have a unique user name. That is, you can't use the same digital-assistant agent for more than one channel. If the same digital-assistant agent is signed in to more than one channel, none of the channels will work as expected.

  1. In Oracle Digital Assistant, click Icon to open the side menu to open the side menu, select Development, and then select Channels.
  2. Click DA as Agent, and then click + Add Agent Channel.
  3. Enter a name and an optional description for this channel.
  4. Select the service (Oracle B2C Service or Oracle Fusion Service).

    If you selected Oracle Fusion Service, then the Authentication Service field displays the name of the IDCS confidential client (also referred to as the OAuth client) that's preconfigured for your paired instance.

  5. Enter the host.

    For Oracle B2C Service, you can derive these values from the URL that you use to launch the Agent Browser User Interface or the chat launch page. For example, if the URL is https://sitename.exampledomain.com/app/chat/chat_launch, then the host is sitename.exampledomain.com.

    For Oracle Fusion Service, this is the host portion of your Oracle Fusion Cloud Applications (Fusion) instance's URL. For example: sitename.exampledomain.com.

  6. Enter the user name and password for the digital-assistant agent that was created in Oracle B2C Service or Oracle Fusion Service. For example: digitalassistant.

    Don't use the same user name for more than one channel. If multiple channels have the same user name, then racing conditions can cause unexpected behavior.

  7. Click Create.
  8. In the Route To drop-down, select the digital assistant to route to.


    Description of da-agent-channelv2.png follows

  9. Switch Interaction Enabled to On.

    The channel establishes a connection with the service and the digital-assistant agent is signed in.

    You should wait at least one minute for the channel connection and sign-on to complete.

    Note

    Don't re-toggle the switch until at least one minute has passed. If you enable the channel and then disable it before the connection is established and sign-on completes (or vice versa), then you might break the connection and the digital assistant won't be able to get or send responses. To resolve a broken connection, delete the channel and then re-create it.

Tip:

If a channel isn't working, click Error Reports to see if there are any reported errors. Note that if you see a CONFLICT error or an ACCESS_DENIED error, you can typically resolve this problem by switching Interaction Enabled to Off, and then switching it to On. Sometimes, however, you might see this problem because the same digital assistant agent is signed in to more than one DA-as-Agent channel.