build-si-agent

What problem does it solve?

Enables teams to implement a Sponsored Intelligence (SI) agent that manages offering discovery, session lifecycle, message exchange, and termination so platforms can serve conversational sponsored content reliably across synchronous and asynchronous AdCP flows.

Core Features & Use Cases

• Offering discovery and tokens: check availability and return offering_token and TTL for buyers to initiate sessions.
• Session lifecycle management: create sessions with session_id and session_status, persist state, and terminate sessions with explicit termination confirmation.
• Message handling with sponsored responses: process user messages and return structured sponsored content responses (content, content_type) while echoing session identifiers.
• Context passthrough and persistence: echo opaque context objects unchanged in every response and use ctx.store for durable session state.
• Developer workflow and testing: auto-generated capabilities, storyboards for validation, and SDK patterns for building and serving SI agents.

Quick Start

Start an SI agent that issues offerings, initiates sessions, responds to messages with sponsored content, and terminates sessions while persisting state and echoing context using the AdCP SDK.