> ## Documentation Index
> Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置模板

> AI代理商务标准配置模板完整合集：包含llms.txt站点描述文件、agent.json能力声明文档、Schema.org Product JSON-LD结构化数据标记与robots.txt爬虫访问规则的完整可用模板，覆盖电商网站和SaaS服务等不同业务场景，替换占位符即可直接部署

# 配置模板

以下模板可以直接复制使用。将 `{{占位符}}` 替换为你的实际信息即可。

## 1. llms.txt 模板

### 电商网站

```markdown theme={null}
# {{品牌名}} — {{一句话描述}}

> {{品牌名}}是{{业务描述}}，主营{{产品类别}}，服务{{目标客群}}。

## 关于我们
{{公司名}}成立于{{年份}}年，总部位于{{城市}}。
{{2-3句话描述公司历史、规模、核心优势}}。
目前在售商品{{数量}}个，覆盖{{主要品类}}。

## 产品分类
- [{{分类1}}](https://{{域名}}/category/{{slug1}}): {{简述}}
- [{{分类2}}](https://{{域名}}/category/{{slug2}}): {{简述}}
- [{{分类3}}](https://{{域名}}/category/{{slug3}}): {{简述}}
- [{{分类4}}](https://{{域名}}/category/{{slug4}}): {{简述}}

## 品牌
{{如有代理品牌，列出品牌名。如无可删除此节。}}

## 配送与退货
- 配送范围: {{配送区域}}
- 配送时效: {{时效描述}}
- 退货政策: {{退货条件概述}}
- [完整退货政策](https://{{域名}}/return-policy)

## 政策
- [隐私政策](https://{{域名}}/privacy-policy)
- [服务条款](https://{{域名}}/terms)

## 联系方式
- 网站: https://{{域名}}
- 客服邮箱: {{邮箱}}
- 客服电话: {{电话}}
- 地址: {{城市}}{{区域}}

## 认证与荣誉
{{如有行业认证、奖项等，列在这里。如无可删除此节。}}
```

### SaaS/服务类网站

```markdown theme={null}
# {{产品名}} — {{一句话描述}}

> {{产品名}}为{{目标客户}}提供{{核心功能}}。

## 关于我们
{{成立时间}}成立，总部{{城市}}。{{客户规模}}客户，覆盖{{行业}}。

## 产品
- [{{功能1}}](https://{{域名}}/{{path1}}): {{描述}}
- [{{功能2}}](https://{{域名}}/{{path2}}): {{描述}}
- [{{功能3}}](https://{{域名}}/{{path3}}): {{描述}}

## 定价
- {{免费版}}: {{限制}}
- {{付费版}}: {{价格}}
- [完整定价](https://{{域名}}/pricing)

## 技术
- API文档: [{{域名}}/docs](https://{{域名}}/docs)
- 状态页: [status.{{域名}}](https://status.{{域名}})

## 联系方式
- 网站: https://{{域名}}
- 邮箱: {{邮箱}}
```

**部署路径**: `https://你的域名/llms.txt`

***

## 2. agent.json 模板

### 基础版（仅商品展示）

```json theme={null}
{
  "schema_version": "1.0",
  "name": "{{品牌名}}",
  "description": "{{一句话描述}}",
  "url": "https://{{域名}}",
  "logo": "https://{{域名}}/logo.png",
  "capabilities": {
    "product_discovery": {
      "enabled": true,
      "formats": ["json-ld"]
    }
  },
  "structured_data": {
    "schema_org": true,
    "llms_txt": true,
    "sitemap": "https://{{域名}}/sitemap.xml"
  },
  "policies": {
    "privacy": "https://{{域名}}/privacy-policy",
    "returns": "https://{{域名}}/return-policy",
    "terms": "https://{{域名}}/terms"
  },
  "contact": {
    "email": "{{客服邮箱}}"
  }
}
```

### 完整版（多协议支持）

```json theme={null}
{
  "schema_version": "1.0",
  "name": "{{品牌名}}",
  "description": "{{一句话描述}}",
  "url": "https://{{域名}}",
  "logo": "https://{{域名}}/logo.png",
  "capabilities": {
    "product_discovery": {
      "enabled": true,
      "protocols": ["ucp"],
      "endpoint": "https://{{域名}}/.well-known/ucp/products",
      "formats": ["json-ld", "json"]
    },
    "checkout": {
      "enabled": {{true/false}},
      "protocols": ["acp"],
      "endpoint": "https://{{域名}}/api/acp/checkout"
    },
    "customer_service": {
      "enabled": {{true/false}},
      "protocols": ["mcp"],
      "endpoint": "https://{{域名}}/api/mcp",
      "tools": ["product_search", "order_status", "return_request"]
    }
  },
  "trust": {
    "otr_id": "{{OTR-ID，可选}}",
    "verification_url": "https://orbexa.io/zh/verify/{{域名}}"
  },
  "structured_data": {
    "schema_org": true,
    "llms_txt": true,
    "sitemap": "https://{{域名}}/sitemap.xml"
  },
  "policies": {
    "privacy": "https://{{域名}}/privacy-policy",
    "returns": "https://{{域名}}/return-policy",
    "terms": "https://{{域名}}/terms"
  },
  "contact": {
    "email": "{{客服邮箱}}",
    "support_url": "https://{{域名}}/support"
  }
}
```

**部署路径**: `https://你的域名/.well-known/agent.json`

***

## 3. Schema.org Product 模板

```html theme={null}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "{{商品名称}}",
  "description": "{{商品描述，50-200字}}",
  "image": [
    "https://{{域名}}/images/{{商品图1}}.jpg",
    "https://{{域名}}/images/{{商品图2}}.jpg"
  ],
  "brand": {
    "@type": "Brand",
    "name": "{{品牌名}}"
  },
  "sku": "{{SKU编号}}",
  "gtin13": "{{EAN/UPC条码，如有}}",
  "offers": {
    "@type": "Offer",
    "url": "https://{{域名}}/product/{{商品slug}}",
    "priceCurrency": "{{货币代码: CNY/USD/EUR}}",
    "price": "{{价格数字}}",
    "availability": "https://schema.org/{{InStock/OutOfStock/PreOrder}}",
    "seller": {
      "@type": "Organization",
      "name": "{{卖家名}}"
    },
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingDestination": {
        "@type": "DefinedRegion",
        "addressCountry": "{{国家代码: CN/US}}"
      },
      "deliveryTime": {
        "@type": "ShippingDeliveryTime",
        "businessDays": {
          "@type": "QuantitativeValue",
          "minValue": {{最快天数}},
          "maxValue": {{最慢天数}}
        }
      }
    },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": {{退货天数}}
    }
  }
}
</script>
```

***

## 4. Schema.org Organization 模板

```html theme={null}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "{{公司名}}",
  "url": "https://{{域名}}",
  "logo": "https://{{域名}}/logo.png",
  "description": "{{一句话描述}}",
  "foundingDate": "{{YYYY-MM-DD}}",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "{{街道地址}}",
    "addressLocality": "{{城市}}",
    "addressRegion": "{{省份}}",
    "postalCode": "{{邮编}}",
    "addressCountry": "{{国家代码}}"
  },
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer service",
    "email": "{{客服邮箱}}",
    "telephone": "{{电话}}"
  },
  "sameAs": [
    "{{社交媒体链接1}}",
    "{{社交媒体链接2}}"
  ]
}
</script>
```

***

## 5. robots.txt 模板（AI友好版）

```
# 传统搜索引擎
User-agent: Googlebot
Allow: /

User-agent: bingbot
Allow: /

# AI代理浏览（推荐商品时实时抓取）
User-agent: ChatGPT-User
Allow: /

User-agent: Claude-Web
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: Applebot-Extended
Allow: /

# AI训练（帮助AI了解你的品牌）
User-agent: GPTBot
Allow: /

User-agent: Google-Extended
Allow: /

# 通用规则
User-agent: *
Allow: /
Disallow: /admin/
Disallow: /checkout/
Disallow: /cart/
Disallow: /account/
Disallow: /api/
Disallow: /wp-admin/

# Sitemap
Sitemap: https://{{域名}}/sitemap.xml
```

***

## 6. DMARC DNS记录模板

```
类型: TXT
名称: _dmarc
值:   v=DMARC1; p=quarantine; rua=mailto:dmarc-reports@{{域名}}; pct=100; adkim=r; aspf=r
```

## 7. SPF DNS记录模板

```
类型: TXT
名称: @
值:   v=spf1 include:{{邮件服务商SPF}} ~all
```

常用邮件服务商SPF：

* Google Workspace: `include:_spf.google.com`
* Microsoft 365: `include:spf.protection.outlook.com`
* Zoho: `include:zoho.com`
* Amazon SES: `include:amazonses.com`

***

## UCP Profile 配置骨架

部署在 `/.well-known/ucp`，声明商家支持的UCP能力：

```json theme={null}
{
  "ucp": {
    "supported_versions": {
      "2026-04-08": {
        "services": {
          "shopping": {
            "checkout": {
              "transport": "rest",
              "endpoint": "https://你的域名/ucp/v1",
              "schema": "https://你的域名/ucp/v1/openapi.json"
            }
          }
        },
        "capabilities": {
          "dev.ucp.shopping.checkout": {
            "version": "2026-04-08"
          }
        }
      }
    },
    "payment_handlers": {}
  },
  "signing_keys": [
    {
      "kid": "你的密钥ID",
      "kty": "EC",
      "crv": "P-256",
      "x": "你的公钥x坐标(Base64url)",
      "y": "你的公钥y坐标(Base64url)",
      "use": "sig",
      "alg": "ES256"
    }
  ]
}
```

**部署要求**: HTTPS、不允许3xx重定向、Cache-Control `public, max-age=60` 以上。

详细说明: [Book 3 第7章](/zh/book-3/ch7-merchant-integration)

***

## ACP Product Feed JSON模板

ACP商品数据的最小可用JSON格式（一个Product含一个Variant）：

```json theme={null}
{
  "id": "prod_001",
  "title": "商品名称",
  "description": {
    "plain": "商品的纯文本描述"
  },
  "url": "https://你的域名/products/prod_001?utm_medium=feed",
  "media": [
    {
      "type": "image",
      "url": "https://你的域名/images/product-main.jpg",
      "alt_text": "商品主图描述"
    }
  ],
  "variants": [
    {
      "id": "var_001_default",
      "title": "商品名称 - 默认规格",
      "price": {
        "amount": 39900,
        "currency": "CNY"
      },
      "availability": {
        "available": true,
        "status": "in_stock"
      },
      "variant_options": [
        { "name": "颜色", "value": "黑色" },
        { "name": "尺码", "value": "M" }
      ]
    }
  ]
}
```

**注意**: `amount` 使用ISO 4217最小货币单位。¥399.00 = `39900`。

详细说明: [Book 4 第2章](/zh/book-4/ch2-product-data)

***

## MCP Server配置模板

Claude Desktop的MCP Server连接配置（`claude_desktop_config.json`）：

```json theme={null}
{
  "mcpServers": {
    "otr-trust": {
      "url": "https://orbexa.io/mcp"
    },
    "你的商务服务": {
      "command": "node",
      "args": ["path/to/your/mcp-server.js"],
      "env": {
        "API_KEY": "你的API密钥"
      }
    }
  }
}
```

详细说明: [Book 5 第4章](/zh/book-5/ch4-build-server)
