build-si-agent

To build a sponsored intelligence agent, implement AdCP SI handlers for offering discovery, session lifecycle, message exchange, and termination. This Skill provides the handlers needed to serve conversational sponsored content reliably across synchronous and asynchronous flows.

Session lifecycle management creates sessions with a session_id and session_status, persists state via ctx.store, and terminates sessions with explicit confirmation. This ensures durable state tracking and clean closure for sponsored content delivery.

Yes, this Skill supports both synchronous and asynchronous AdCP flows. It processes user messages and returns structured sponsored content responses with content and content_type while echoing session identifiers across both communication patterns.

Offering discovery checks availability and returns an offering_token with a TTL for buyers to initiate sessions. This mechanism allows platforms to manage and validate sponsored content opportunities before session creation.

No, you do not need to manually manage session state. The Skill uses ctx.store for durable session state persistence and echoes opaque context objects unchanged in every response, handling state automatically.

The best way to validate an SI agent is using the auto-generated capabilities and storyboards provided. These SDK patterns allow you to test offering discovery, session initiation, message handling, and termination before deployment.