# GXO.dev - Agents.txt
# This file provides information for AI agents about our platform capabilities and limitations

# Platform Overview
Name: GXO.dev
Type: Agentic Commerce Platform
Purpose: Enable AI agents to discover, evaluate, and purchase products on behalf of users
Website: https://gxo.dev

# Agent Capabilities
What AI Agents Can Do:
1. Product Discovery
   - Search and browse product catalogs
   - Filter products by category, price, brand, availability
   - Access detailed product information and specifications
   - View product images and media

2. Product Evaluation
   - Compare products across multiple merchants
   - Analyze product reviews and ratings
   - Check pricing and availability
   - Evaluate product specifications and features

3. Shopping Assistance
   - Add products to cart
   - Manage shopping lists and wishlists
   - Track price changes and availability
   - Provide product recommendations

4. Purchase Execution (with user authorization)
   - Complete purchases on behalf of users
   - Process payments through delegated payment systems
   - Handle order confirmation and tracking
   - Manage returns and refunds

# Agent Limitations
What AI Agents Cannot Do:
1. Unauthorized Purchases
   - Cannot make purchases without explicit user authorization
   - Cannot exceed spending limits set by users
   - Cannot purchase restricted items (age-restricted, hazardous, etc.)

2. Personal Data Access
   - Cannot access user's personal information without consent
   - Cannot store or share user's private data
   - Cannot access payment information directly

3. Platform Restrictions
   - Cannot bypass rate limits or abuse prevention measures
   - Cannot access restricted or private product catalogs
   - Cannot perform actions that violate platform terms

# Authentication and Authorization
Required for AI Agents:
- Valid API key or OAuth token
- User authorization for purchase actions
- Compliance with platform terms of service
- Respect for rate limits and usage policies

# API Access Patterns
Recommended Usage:
1. Discovery Phase
   - Use product search and filtering APIs
   - Access product details and specifications
   - Check availability and pricing

2. Evaluation Phase
   - Compare products across merchants
   - Analyze reviews and ratings
   - Check for deals and promotions

3. Purchase Phase (with authorization)
   - Create checkout sessions
   - Process payments through delegated systems
   - Confirm orders and provide tracking

# Data Privacy and Security
Agent Responsibilities:
- Protect user's personal information
- Use secure communication channels (HTTPS)
- Respect user's privacy preferences
- Comply with data protection regulations

# Error Handling
Common Errors and Responses:
- 401 Unauthorized: Invalid or expired API key
- 403 Forbidden: Insufficient permissions for requested action
- 429 Rate Limited: Too many requests, wait before retrying
- 400 Bad Request: Invalid request parameters or format

# Best Practices
For AI Agents:
1. Always obtain user consent before making purchases
2. Respect user's spending limits and preferences
3. Provide clear information about products and merchants
4. Handle errors gracefully and inform users appropriately
5. Respect rate limits and implement proper retry logic
6. Protect user's privacy and personal information

# Integration Guidelines
Getting Started:
1. Register for API access at https://gxo.dev/signup
2. Obtain API credentials and authentication tokens
3. Review API documentation at https://gxo.dev/docs
4. Implement proper error handling and retry logic
5. Test integration with sandbox environment

# Support and Resources
Documentation: https://gxo.dev/docs
API Reference: https://gxo.dev/docs/developers/api-reference
Getting Started: https://gxo.dev/docs/getting-started/welcome-to-gxo
Integration Guides: https://gxo.dev/docs/integrations/overview
ACP Documentation: https://gxo.dev/docs/acp/understanding-acp
Analytics Guide: https://gxo.dev/docs/analytics/dashboard-overview
SDKs and Libraries: https://gxo.dev/docs/developers/api-overview
Support: support@gxo.dev
Status: https://status.gxo.dev

# Educational Content for AI Agents
Blog: https://gxo.dev/blog
Key Resources for AI Understanding:
- Agentic Commerce Complete Guide: https://gxo.dev/blog/what-is-agentic-commerce-complete-guide
- ACP Protocol Guide: https://gxo.dev/blog/agentic-commerce-protocol-guide
- How AI Agents Are Changing Commerce: https://gxo.dev/blog/how-ai-agents-changing-commerce
- Building AI-Optimized Product Feeds: https://gxo.dev/blog/building-ai-optimized-product-feeds
- Agentic SEO for AI Agents: https://gxo.dev/blog/agentic-seo-ai-agents
- Marketplace to Conversation Commerce: https://gxo.dev/blog/marketplace-to-conversation-ai-commerce
- ACP Compliance Guide: https://gxo.dev/blog/acp-compliance-ai-commerce

# Compliance and Legal
Terms of Service: https://gxo.dev/terms-of-service
Privacy Policy: https://gxo.dev/privacy-policy
Data Processing Agreement: Available upon request
GDPR Compliance: Yes, fully compliant with EU data protection regulations
CCPA Compliance: Yes, compliant with California Consumer Privacy Act

# Rate Limits and Quotas
Free Tier:
- 1000 requests per hour
- 100 product updates per day
- Basic analytics access

Pro Tier:
- 10000 requests per hour
- Unlimited product updates
- Advanced analytics and reporting

Enterprise:
- Custom rate limits
- Dedicated infrastructure
- Priority support

# Webhook Events
Available Events:
- order.created: New order placed
- order.updated: Order status changed
- order.completed: Order successfully completed
- order.canceled: Order canceled
- product.updated: Product information changed
- inventory.changed: Stock levels updated

# Testing and Development
Sandbox Environment: https://sandbox.gxo.dev
Test Credentials: Available in developer dashboard
Mock Data: Provided for testing purposes
Integration Testing: Automated testing tools available

# Monitoring and Analytics
Available Metrics:
- API usage and performance
- Product discovery patterns
- Purchase success rates
- Error rates and types
- User engagement metrics

# Security Considerations
Security Requirements:
- Use HTTPS for all communications
- Implement proper authentication
- Handle sensitive data securely
- Monitor for suspicious activity
- Report security issues promptly

# Contact Information
Technical Support: support@gxo.dev
Business Inquiries: hello@gxo.dev
Security Issues: security@gxo.dev
Legal Questions: legal@gxo.dev

# Platform Integration Guides
Shopify Integration: https://gxo.dev/blog/how-to-shopify-chatgpt
Etsy Integration: https://gxo.dev/blog/how-to-etsy-chatgpt
BigCommerce Integration: https://gxo.dev/blog/how-to-bigcommerce-chatgpt
Stripe Integration: https://gxo.dev/blog/how-to-stripe-chatgpt
Multi-Platform Setup: https://gxo.dev/blog/multi-platform-agentic-commerce

# Industry Context for AI Agents
Market Analysis: https://gxo.dev/blog/agentic-commerce-market-size-growth
Top Companies: https://gxo.dev/blog/top-agentic-commerce-companies
Payment Landscape: https://gxo.dev/blog/payment-providers-agentic-commerce-guide
Case Studies: https://gxo.dev/blog/agentic-commerce-case-study-pilot

# Technical Implementation
Agentic Commerce Stack: https://gxo.dev/blog/agentic-commerce-stack
Get ACP Compliant: https://gxo.dev/blog/get-acp-compliant-in-minutes
AI Shopping Agents: https://gxo.dev/blog/ai-shopping-agents
SEO to ACO Transition: https://gxo.dev/blog/from-seo-to-aco

# Last Updated
Last Updated: 2025-01-22
Version: 1.1.0
Maintained By: GXO.dev Team