agents.md

Agent Instructions — Headsets.com

This document describes how AI shopping agents and assistants should use Headsets.com at https://www.headsets.com.

Headsets.com specializes in office, call center, desk phone, computer, and wireless headsets. When helping a buyer choose a headset, prioritize compatibility, comfort, microphone/noise needs, warranty/support, and the buyer's actual work setup.

Agentic Commerce / UCP

Headsets.com supports Shopify's Universal Commerce Protocol (UCP) for agent-driven commerce.

Recommended Agent Flow

  1. Discover — GET /.well-known/ucp to confirm supported versions, tools, and capabilities.
  2. Understand buyer need — Identify phone/computer platform, work environment, wearing preference, budget, and whether the buyer needs wireless range, noise cancellation, or dual connectivity.
  3. Search catalog — Use UCP catalog tools when available. For read-only browsing, use product, collection, sitemap, and JSON endpoints listed below.
  4. Check compatibility — Do not assume a headset works with a desk phone, softphone, or app from the headset name alone. Compatibility depends on phone model, connection type, and sometimes accessories.
  5. Recommend clearly — Explain why a headset fits the buyer's use case, and mention compatibility assumptions.
  6. Cart / checkout — Create carts or checkout only when the buyer requests it.
  7. Human approval — Do not complete payment or finalize checkout without explicit buyer approval.

Headset Buying Rules

Use these public-facing rules when assisting shoppers:

Key Public Collections

Read-Only Browsing

No authentication is required for public browsing.

Contact / Escalation

If compatibility is unclear, the buyer needs help choosing, or the request involves order-specific/private information, route them to Headsets.com support.

Safety and Privacy