agentgrade

EnglishEspañol日本語中文
← Knowledge Base

5分钟检查清单

以下四个文件可以让您的网站对 AI 代理可见。每个文件只需几分钟即可添加,并能立即提高您的 agentgrade 评分。

1. 添加 llms.txt

创建 /llms.txt —— 一个供 LLM 使用的纯文本服务描述文件:

# Your Service Name

> One-line description of what your service does.

## API

GET /api/search?q=term — Search items
POST /api/create — Create an item (requires auth)

## Example

curl "https://yoursite.com/api/search?q=test"

原因: LLM 通过读取此文件来了解您的服务功能和使用方式。文件以 H1 标题开头即可通过验证检查。

2. 添加 OpenAPI 规范

/openapi.json 路径提供 API 端点描述:

{
  "openapi": "3.0.0",
  "info": { "title": "Your API", "version": "1.0" },
  "paths": {
    "/api/search": {
      "get": {
        "summary": "Search items",
        "parameters": [
          { "name": "q", "in": "query", "schema": { "type": "string" } }
        ]
      }
    }
  }
}

原因: 代理通过此文件了解可用的端点及其调用方式。大多数框架可以自动生成此文件。

3. 添加包含代理指令的 robots.txt

/robots.txt 中添加针对代理的规则:

User-agent: GPTBot
Allow: /

User-agent: Claude-Web
Allow: /

User-agent: Anthropic-AI
Allow: /

原因: 表明您的网站欢迎 AI 代理访问。许多网站默认屏蔽 AI 爬虫。

4. 添加健康检查端点

/health 路径返回 JSON:

{ "status": "ok" }

原因: 代理和监控工具在发送请求前,会通过此端点检查您的服务是否正常运行。

后续步骤

基础配置完成后,可以考虑:

扫描您的网站

agentgrade.com 输入您的域名,查看当前评分和缺失项。