Hey @Sourabh_Nyalkalkar - thanks for the detailed questions. Shopify’s Personal Agent Protocol support went live today: Online Store domains now serve a discovery file at /.well-known/poppy.json (the spec calls the protocol “Poppy” for short), and that file points personal agents to the store’s UCP profile. The protocol covers discovery, agent identity and sign-in. Carts, checkout and orders happen through UCP. One thing to keep in mind for attribution: agents can also use UCP without the Personal Agent Protocol (see its UCP extension), so a UCP order on its own doesn’t tell you the protocol was involved.
Order attribution
Nothing documented today marks an order as coming from a Personal Agent Protocol session, whether that’s a channel, a note attribute or an order field. What you can read is the source the order is attributed to. According to the Help Center, orders placed through personal AI agents show in the admin with attribution to the agent. On the Admin API, that’s in:
Order.sourceNameandOrder.appOrder.attribution(API version 2026-07 and later)
These tell you who the order is attributed to, not which protocol the agent used. An agent that browses the storefront and checks out there looks like a regular visitor, so its order is attributed to that storefront plus any referrer or UTM data it carried.
For reporting, ShopifyQL has agentic_referring_channel (sessions and order-level reports) and agentic_sales_channel (sales). Both cover specific named AI channels and don’t identify the protocol.
Session identity
The protocol’s session ID travels in a request header between the agent and the store. There’s no documented way for apps to get it through webhooks, the Admin API or Customer Events.
Merchant controls
Merchants manage agentic channels, including direct checkout, in Sales channels > Agentic in their admin. I can’t yet confirm how those settings apply to agents that arrive through the Personal Agent Protocol, and I couldn’t find a public Admin API that reads or manages them. I’ve asked the team about this and will update this thread when I have an answer.