Share current tab

Share current tab lets the agent read and interpret the page’s content, giving it full awareness of the page’s structure and elements so it can guide users based on what’s on the page. This is the page context the agent reasons over on each turn (see Context).

Turn it on and tune it from your agent’s settings in the dashboard — that’s the primary way to configure it. The SDK settings below are an override: use setConfiguration({ screenSharingSettings }) to control it programmatically, per page or per session, on top of the dashboard defaults.

SDK override

active

Enables or disables the Shared Current Tab feature. When true, the agent can read and understand the content of the current page to provide contextual assistance, suggest actions, or highlight relevant information without making any changes directly.

• Type: boolean
• Default Value: false

tooltipText

One-line hover label shown on the Agent control. Use this to clearly explain what enabling Shared Current Tab does in a short, non-technical way that reassures users about control and privacy.

• Type: string
• Default Value: "Let the assistant understand this page and help you."

tooltipStarters

Array of up to 2 short suggested prompts shown in the UI to help users quickly start interactions using Shared Current Tab. Hints should be concise, actionable, and reassure users that the agent only reads the page to assist, without modifying it.

• Type: array
• Default Value: [ "Summarize this", "Explain what I'm seeing" ]

shareMode

Determines what type of data the SDK includes when the user shares their screen with the agent. This controls whether the agent receives only an image of the page, only its HTML structure, or both.

• Type: "image" | "html" | "both"
• Default Value: "both"

Example

foldspace.agent('YOUR-AGENT-KEY').setConfiguration({
  screenSharingSettings: {
    active: true,
    tooltipText: "Allow the assistant to understand this page and provide helpful suggestions",
    tooltipStarters: [
      "Summarize this page for me",
      "Highlight important information here"
    ],
    shareMode: "both"
  }
});