> ## 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.

# Acceso de IA

> Compara las políticas de robots.txt con las respuestas observadas en las comprobaciones de agentes de usuario de rastreadores de IA.

La API de acceso de IA comprueba la política de robots.txt y envía solicitudes HTTP con agentes de usuario de rastreadores de IA desde la red de Athena. Utiliza los resultados para investigar solicitudes fallidas o compartir diagnósticos con tu proveedor de alojamiento o CDN. Estas comprobaciones no verifican el acceso desde los rangos de IP de los rastreadores reales ni garantizan la indexación o las citas.

## Qué devuelve

* **`result.evidence`** contiene las observaciones de referencia de cada agente. `http` indica `true` si se ha superado la comprobación, `false` si la solicitud se ha denegado y `null` si el acceso es desconocido. `robots` informa de la política de forma independiente, o devuelve `null` cuando no se ha podido evaluar el archivo. `network` es `athena` y `version` es `2`.
* **`diagnostics`** registra el estado HTTP, el veredicto, las cabeceras de respuesta, el código de error, la duración y la marca de tiempo UTC de cada solicitud. Utiliza estos datos para localizar las solicitudes en los registros de tu servidor o CDN. Los identificadores que solo expresan una política utilizan `not_tested`, sin estado HTTP ni error de solicitud.
* **`log`** presenta los diagnósticos de las solicitudes con un formato adecuado para una incidencia de soporte. Su estado global utiliza `result.evidence.status` para distinguir el acceso desconocido de un bloqueo.

Los campos anteriores `result.status`, `result.http` y `result.robots` se mantienen por compatibilidad. Combinan las funciones de los rastreadores y no permiten distinguir el acceso desconocido. Cuando no hay una observación HTTP de Google-Extended, el booleano anterior `result.http.gemini.training` utiliza la respuesta medida de Googlebot como referencia de compatibilidad. Esto no demuestra que Gemini tenga acceso o permiso para usar el contenido en su entrenamiento. La política de robots.txt de Google-Extended se mantiene independiente y su evidencia HTTP sin procesar sigue siendo `null`, ya que [Google-Extended no tiene un agente de usuario HTTP dedicado](https://developers.google.com/crawling/docs/crawlers-fetchers/google-common-crawlers#google-extended). Las nuevas integraciones deben utilizar `result.evidence` y los diagnósticos por agente. Esta comprobación no analiza los sitemaps.

## Búsqueda, recuperación y entrenamiento por separado

| Agente | Finalidad |
| - | - |
| `chatgpt.ChatGPTUser` | Recuperación iniciada por el usuario. Es posible que no se apliquen las reglas de robots.txt. |
| `chatgpt.OAISearchBot` | Búsqueda de ChatGPT. |
| `chatgpt.GPTBot` | Entrenamiento de modelos. Su política es independiente de la búsqueda. |
| `claude.ClaudeUser` | Recuperación iniciada por el usuario. |
| `claude.ClaudeSearchBot` | Indexación para búsquedas. |
| `claude.ClaudeBot` | Entrenamiento de modelos. |
| `gemini.GoogleExtended` | Identificador de política de robots.txt para entrenamiento y fundamentación de respuestas, sin rastreador HTTP. La evidencia HTTP es `null`. |

## Valores del estado de la evidencia

`result.evidence.status` resume las observaciones HTTP de forma independiente de robots.txt. Google-Extended queda excluido porque no tiene rastreador HTTP.

| Valor | Significado |
| - | - |
| `accessible` | Se han superado todas las solicitudes de rastreadores comprobadas. |
| `partial` | Algunas solicitudes se han denegado; otras se han superado o no han dado un resultado concluyente. |
| `blocked` | Se han denegado todas las solicitudes de rastreadores comprobadas. |
| `inconclusive` | No se ha denegado ninguna solicitud, pero al menos una observación es desconocida o ha fallado la comprobación en directo. |

Un desafío de seguridad puede devolver HTTP 200. Los desafíos, los límites de solicitudes, los fallos de red, los tiempos de espera agotados y los errores habituales del servidor significan que el acceso es desconocido. Una solicitud denegada también aporta evidencia sobre la comprobación de Athena, sin demostrar por sí sola que el rastreador real esté bloqueado. Confirma el tráfico real del rastreador en los registros de tu servidor o CDN.

## Límites de solicitudes y autenticación

Utiliza la [autenticación estándar mediante claves de API de AthenaHQ](https://docs.athenahq.ai/es/api-reference/authentication.md). El endpoint permite **30 solicitudes por minuto por organización**. Si superas el límite, devuelve `429` con `Retry-After`.

## Referencia del endpoint

Consulta [POST /api/v1/ai-access/check](https://docs.athenahq.ai/es/api-reference/ai-access/check-ai-accessibility-for-a-domain.md) para ver el esquema completo de la solicitud y la respuesta.


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