SDK Configuration Reference

Appearance & Greeting

Defines how the agent looks, introduces itself, and aligns with your brand.

Interaction & Communication

Defines how users engage with the agent through text or voice.

Placement & Rendering

Determines how the agent is embedded, anchored, and behaves on screen.

Theme Settings

Defines the colors and typography styles used in the Agent interface.

Dark Mode Settings

Controls dark mode activation and theme configuration.

Border Animation Settings

Defines animated border effects for highlighting the agent.

Conversation Starters Settings

Manages predefined prompts and behaviors for starting conversations.

Style Override Settings

Provides customization hooks for overriding SDK component styles.

Share State Settings

Enables the SDK to access and share specific application states exposed by the host app.

<Card title="Embedded Mode Configuration" href="./embedded-mode-configuration">
Embedded mode allows you to mount the agent directly into a specific DOM element within your application layout.
</Card>

Examples

An example showcasing how to customize your Foldspace Agent’s look and behavior.

You can also configure all of these settings in our Studio. Note that any SDK-side configuration will override the Studio values—allowing you to vary settings on a per-page or contextual basis.