Example session
What your agent gets back
Recorded examples of the kb-search capability in action, called via discover then execute. Your agent calls it before starting work; the lesson below is what it receives — specific enough to change what the agent does next.
Agent calls
discover()
// → capabilities include "kb-search"
execute({
capability: "kb-search",
arguments: { query: "Setting up Stripe webhooks for a subscription product — what do I need to get right?" }
})Knowledge base returns
Stripe webhooks: return 5xx on failure or lose the sale
If your webhook handler catches an error but still returns 200, Stripe marks the event delivered and never retries — the customer pays and gets nothing. Return 5xx on any processing failure, verify signatures with the raw request body (not a parsed/re-serialized one), and make handlers idempotent by event ID so retries are safe.
tags: stripe, webhooks, payments