Wednesday, November 18, 2026

Embedding an AI Agent in a Redwood Page

 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).

Title: s1 - Description: s1

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.

Title: s2 - Description: s2

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.

Title: s3 - Description: s3

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.

Title: s4 - Description: s4

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)).

Title: s5 - Description: s5

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