Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
AdCP 3.1 is released — see what's new →
AdCP Sponsored Intelligence task reference. Four tasks covering the full session lifecycle: si_get_offering, si_initiate_session, si_send_message, and si_terminate_session with MCP and A2A transport examples.
si_get_offering first to show products before consent. The offering_token carries what was shown into the session.
Direct session (solid line): Host calls si_initiate_session directly. Brand agent shows products as part of the conversation and tracks them internally.
Both are valid. Use pre-session lookup for sponsored search results where you want to preview products before asking the user to engage.
| Task | Description | Initiator |
|---|---|---|
si_get_offering | Get offering details, availability, and matching products (anonymous) | Host |
si_initiate_session | Start a conversation with a brand agent | Host |
si_send_message | Exchange messages within an active session | Host |
si_terminate_session | End the session with appropriate handoff | Either |
{
"method": "tools/call",
"params": {
"name": "si_initiate_session",
"arguments": {
"context": "User wants to fly to Boston next Tuesday morning",
"identity": { /* ... */ }
}
}
}
{
"task": "si_initiate_session",
"payload": {
"context": "User wants to fly to Boston next Tuesday morning",
"identity": { /* ... */ }
}
}
{
"context": "User interested in product information",
"identity": {
"consent_granted": false,
"anonymous_session_id": "anon_xyz789"
}
}
{
"context": "User wants to book a flight",
"identity": {
"consent_granted": true,
"consent_timestamp": "2026-01-18T10:30:00Z",
"consent_scope": ["name", "email", "shipping_address"],
"user": {
"email": "jane@example.com",
"name": "Jane Smith"
}
}
}
{
"context": "User searching for flights to Boston",
"media_buy_id": "media_buy_q1_promo",
"placement": "chatgpt_search",
"offering_id": "premium_upgrade_offer",
"identity": {
"consent_granted": true,
"user": { "email": "jane@example.com" }
}
}
Was this page helpful?