Overview
This guide explains how to embed
a configured AI Agent in a Redwood page using a Guided Journey. The approach
has two parts: first, create a Guided Journey that contains an Agent task;
second, attach that journey to a Redwood page through Visual Builder Studio by
adding the journey code to the page properties. Once published, users can reach
the agent from the embedded page and from the AI Chat entry point.
|
Optional
step. Embedding
the agent in a Redwood page is optional. The agent can also be used on its
own through Me > AI Chat. |
Prerequisites
•
An AI Agent that is already configured and available to
select as a workflow agent.
•
Access to Journeys Setup under My Client Groups.
•
Access to Visual Builder Studio for editing Redwood
pages.
•
The target Redwood page identified (for example, the My
Compensation page used in this guide).
Part 1: Create the Guided Journey
Step 1: Open Guided Journey setup
1.
Navigate to My Client Groups > Journeys Setup
> Guided Journey.
2.
Click Create to create a new guided journey and
provide the required details (name, code and so on).

Figure 1: Journeys Setup landing page.
Select the Guided Journey tile.
Step 2: Add an Agent task
1.
In the guided journey, add a task by clicking Add
under Tasks.
2.
Enter a Task Name (for example, Compensation
Advisor (My Team)).
3.
Set Task Type to Agent.
4.
Set Agent Type to Workflow Agent (shown
in the screenshot).
5.
In Workflow Agent, select the agent you
configured earlier.
6.
Click Save.

Figure 2: New Task dialog. The task name
and the Task Type / Agent Type / Workflow Agent fields are highlighted.
Step 3: Note the Guided Journey Code, then save and activate
1.
Make a note of the Guided Journey Code. You will
need it in Part 2. In this example the code is JT_AI_COMPENSATION_ADVISOR_(MY_TEAM).
2.
Confirm the Agent task appears under Tasks with
Task Type = Agent and status Active.
3.
Save and activate the guided journey so its status
shows Active.

Figure 3: Guided journey overview. The
code and the Agent task are highlighted.
|
Tip.
Copy the code
exactly as shown, including any brackets or underscores. A mismatch will
prevent the agent from appearing on the page. |
Part 2: Attach the Journey to a Redwood Page
Step 4: Open the page in Visual Builder Studio
1.
Navigate to the Redwood page you want to embed the
guided journey in.
2.
Click your profile icon to open Settings and Actions,
then select Edit Page in Visual Builder Studio under Administration.

Figure 4: Settings and Actions menu with
Edit Page in Visual Builder Studio highlighted.
Step 5: Add the Guided Journey Code to the page properties
1.
In Visual Builder Studio, open the Page Properties
panel on the right.
2.
Under Guided Journey, find Set Guided
Journeys Code at the Page Level.
3.
Paste the guided journey code you noted in Step 3 (for
example, JT_AI_COMPENSATION_ADVISOR_(MY_TEAM)).

Figure 5: The My Compensation page (left)
shows the agent banner with an Ask Oracle button once the journey code is set
in Page Properties (right).
Step 6: Test and publish
1.
Preview the page and confirm the agent banner appears
with the Ask Oracle button.
2.
Open the agent and run a test question to confirm it
responds as expected.
3.
Publish the changes in Visual Builder Studio.
Accessing and Using the Agent
After the agent is configured,
users can reach it in either of two ways:
•
Me > AI Chat from the global navigation.
•
The Redwood page where the agent is embedded,
using the banner and Ask Oracle button (for example, on the My Compensation
page).
Quick Reference
|
Step |
Action |
Where |
|
1 |
Create a guided journey |
My Client Groups > Journeys Setup > Guided
Journey > Create |
|
2 |
Add task: Task Type = Agent, Agent Type = Workflow
Agent, select your agent |
Guided journey > Tasks > Add |
|
3 |
Note the Guided Journey Code, then save and activate |
Guided journey overview page |
|
4 |
Open the Redwood page in Visual Builder Studio |
Settings and Actions > Edit Page in Visual Builder
Studio |
|
5 |
Enter the journey code at the page level |
Page Properties > Guided Journey |
|
6 |
Test and publish |
Visual Builder Studio |
No comments:
Post a Comment