test-sales-agent · version 1.0.0 · for sellers.
When to use
- A seller is connecting its own AdCP sales agent, or its ad server through a managed sales agent.
- An inventory source shows an error or unhealthy state and the seller wants to check it again.
- A seller wants to see how its storefront agent answers a brief before real buyers send one.
Before you start
- You are connected to the seller account with a role that can change its storefront.
- You know the agent’s endpoint URL, its protocol (
MCPorA2A) and its authentication type. - Any credential is already in your environment. Never ask the person to paste it into chat.
Steps
- Call
get_statusand confirm the seller account. - Call
open_seller_setupwithfocus: "inventory_sources"to show the setup checks. - Call
searchwithkind: "inventory_source". If the source already exists, keep its id and update it instead of adding a second one. - Call
save_inventory_sourcewithname,executionType(AGENTfor your own sales agent),endpointUrl,protocol,authenticationType,credentials,productModeandrunDiscoveryTest: true. PasssourceIdwhen updating. Confirm with the person if asked. - Call
getwithkind: "inventory_source"and the id. Read its health and the discovery test result. If the test failed, report the error, fix the URL or authentication with the person, and run step 4 again. - Send a practice brief. Call
save_rfpwithaction: "create",origin: "manual",purpose: "evaluation", arequest(brief, budget, currency, flight, channels, countries) and aclientRequestId. - Call
open_proposal_passwith therfpIdandturnId, orgetwithkind: "rfp". Check that the products came from the source you connected and that prices respect your floors. - To coach the storefront agent, call
save_rfpwithaction: "append_turn", theparentTurnIdand a newrequest.instruction. Record your verdict withaction: "record_feedback"and agrade. - Call
open_seller_setupwithfocus: "publish_validation"to see whether the end-to-end sandbox check has passed.
Guardrails
- Practice briefs use
purpose: "evaluation". Never create aliveRFP to test. - Credentials are write-only; never echo them, log them or ask for them in chat.
- Do not change the listing, marketplace participation, playbook or AI Business Rules as part of a test unless the person asks.
- A test never contacts real buyers and never books real spend.
Done when
- The inventory source reports healthy and its discovery test returned products.
- A practice RFP turn shows products from that source.
- You have given the person the evidence: source id, health, RFP and turn ids, the products returned, and every issue with its suggested fix.