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

# Accès des IA

> Comparez les règles robots.txt aux réponses observées lors de tests avec les agents utilisateurs des robots d’IA.

L’API AI Access vérifie les règles robots.txt et envoie des requêtes HTTP utilisant les agents utilisateurs des robots d’IA depuis le réseau d’Athena. Ces éléments vous permettent d’analyser les échecs de requête ou de transmettre un diagnostic à votre hébergeur ou à votre CDN. Ces tests ne vérifient pas l’accès depuis les plages d’adresses IP des véritables robots et ne garantissent ni l’indexation ni les citations.

## Informations renvoyées

* **`result.evidence`** contient les observations de référence pour chaque agent. `http` vaut `true` si le test réussit, `false` s’il est refusé et `null` si l’accès est indéterminé. `robots` indique les règles indépendamment, ou vaut `null` lorsque le fichier n’a pas pu être évalué. `network` vaut `athena` et `version` vaut `2`.
* **`diagnostics`** consigne pour chaque requête le statut HTTP, le verdict, les en-têtes de réponse, le code d’erreur, la durée et l’horodatage UTC. Utilisez ces empreintes pour retrouver les requêtes dans les journaux de votre serveur ou CDN. Les jetons servant uniquement aux règles utilisent `not_tested`, sans statut HTTP ni erreur de requête.
* **`log`** présente le diagnostic des requêtes dans un format adapté à un ticket d’assistance. Son statut global utilise `result.evidence.status` pour distinguer un accès indéterminé d’un blocage.

Les anciens champs `result.status`, `result.http` et `result.robots` sont conservés pour des raisons de compatibilité. Ils regroupent les rôles des robots et ne permettent pas d’identifier un accès indéterminé. Lorsque Google-Extended n’a aucune observation HTTP, l’ancien booléen `result.http.gemini.training` utilise la réponse mesurée de Googlebot comme approximation de compatibilité. Cela ne prouve ni l’accès ni l’autorisation pour l’entraînement de Gemini. Les règles robots.txt de Google-Extended restent indépendantes et ses données HTTP brutes restent `null`, car [Google-Extended n’a pas d’agent utilisateur HTTP dédié](https://developers.google.com/crawling/docs/crawlers-fetchers/google-common-crawlers#google-extended). Les nouvelles intégrations doivent utiliser `result.evidence` et les diagnostics par agent. Ce test ne vérifie pas les sitemaps.

## Distinguer recherche, récupération et entraînement

| Agent | Rôle |
| - | - |
| `chatgpt.ChatGPTUser` | Récupération déclenchée par l’utilisateur. Les règles robots.txt peuvent ne pas s’appliquer. |
| `chatgpt.OAISearchBot` | Recherche ChatGPT. |
| `chatgpt.GPTBot` | Entraînement des modèles. Ses règles sont indépendantes de celles de la recherche. |
| `claude.ClaudeUser` | Récupération déclenchée par l’utilisateur. |
| `claude.ClaudeSearchBot` | Indexation pour la recherche. |
| `claude.ClaudeBot` | Entraînement des modèles. |
| `gemini.GoogleExtended` | Jeton de règles robots.txt pour l’entraînement et l’ancrage des réponses, sans robot HTTP. Les données HTTP valent `null`. |

## Valeurs du statut des observations

`result.evidence.status` résume les observations HTTP, indépendamment de robots.txt. Google-Extended en est exclu, car il n’a pas de robot HTTP.

| Valeur | Signification |
| - | - |
| `accessible` | Toutes les requêtes de robots testées ont réussi. |
| `partial` | Certaines requêtes ont été refusées ; d’autres ont réussi ou n’ont pas donné de résultat concluant. |
| `blocked` | Toutes les requêtes de robots testées ont été refusées. |
| `inconclusive` | Aucune requête n’a été refusée, mais au moins une observation est indéterminée ou la vérification en direct a échoué. |

Un défi de vérification peut renvoyer HTTP 200. Les défis, les limites de débit, les défaillances réseau, les délais d’attente et les erreurs serveur ordinaires correspondent à un accès indéterminé. Une requête refusée renseigne également sur le test d’Athena, sans prouver que le véritable robot est bloqué. Confirmez le trafic réel des robots à l’aide des journaux de votre serveur ou CDN.

## Limites de débit et authentification

Utilisez l’[authentification standard par clé API AthenaHQ](https://docs.athenahq.ai/fr/api-reference/authentication.md). Le point de terminaison autorise **30 requêtes par minute et par organisation**. Tout dépassement renvoie `429` avec `Retry-After`.

## Référence du point de terminaison

Consultez [POST /api/v1/ai-access/check](https://docs.athenahq.ai/fr/api-reference/ai-access/check-ai-accessibility-for-a-domain.md) pour obtenir le schéma complet des requêtes et des réponses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.