Obtener RPM máximo de la organización

Obtenga el RPM máximo (solicitudes por minuto) de la organización por intervalo de tiempo: primero, sume el número de solicitudes de todos los Agentes de la organización en el mismo minuto, luego tome el minuto más alto dentro del intervalo, y al mismo tiempo devuelva el momento en que ocurrió el pico, el RPM promedio y el total de solicitudes.

Nota: se puede consultar un máximo de 31 días de datos; solo se contabilizan los canales del espacio de desarrollo, el alcance del conteo se encuentra a continuación en «Criterios de conteo».

Método de solicitud

GET

URL de llamada

https://api-${endpoint}.gptbots.ai/v1/org/stat/rpm

Verificación de llamada

Use la autenticación Basic con DevKey / DevSecret a nivel de cuenta: Authorization: Basic ${BASIC_TOKEN}, donde ${BASIC_TOKEN} es la codificación Base64 de DevKey:DevSecret.

• La cuenta que llama debe ser miembro de la organización correspondiente a org_id y tener el permiso de «Ver uso» (el Owner y los administradores de la organización lo tienen por defecto).
• Por favor, llame a la URL del centro de datos donde se encuentra la organización, tomando ${endpoint} del resultado de Consultar lista de organizaciones como region (SG → sg, TH → th, JP → jp). Llamar a otro centro de datos devolverá «No es miembro de esta organización».

Frecuencia de llamadas

• Cada clave de desarrollador puede llamar a esta API un máximo de 60 veces por minuto.
• Cada llamada se contabiliza en el límite por minuto de la API de tipo estadístico del paquete de la organización, compartido con las llamadas de la interfaz tipo estadística de Agent API Key.
• Los datos se actualizan cada hora, y las consultas repetidas dentro de la misma hora devuelven el mismo resultado. Se recomienda llamar una vez por hora.

Solicitud

Ejemplo de solicitud

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/stat/rpm?org_id=${org_id}&start_time=1788192000000&end_time=1788796800000' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

                    

Encabezados de la solicitud

Parámetros de la solicitud

Respuesta

Ejemplo de respuesta

                      
                      {
    "code": 0,
    "message": "OK",
    "data": {
        "org_id": "65f0c2a1b4e8d93a1c7e5b20",
        "range_start": 1788192000000,
        "range_end": 1788796800000,
        "data_until": 1788793200000,
        "data_since": 1786125600000,
        "peak_rpm": 186,
        "peak_at": 1788512460000,
        "avg_rpm": 12.40,
        "total_requests": 2083411
    }
}

                    

Respuesta exitosa

Respuesta fallida

Códigos de error

El código de estado HTTP corresponde a los tres primeros dígitos del código de error, por ejemplo 40000 corresponde a 400, 40100 corresponde a 401, 403132 corresponde a 403.

Criterios estadísticos

• Solicitudes: Mensajes de pregunta enviados por el usuario, incluyendo errores en el diálogo (incluidas las solicitudes rechazadas por exceder la frecuencia de llamadas), consistentes con "Agent Insights → Solicitudes por minuto" en la consola. No se refiere al número de solicitudes HTTP, y el conteo puede diferir del límite de paquete.
• Alcance estadístico: Solo se cuentan las solicitudes de Agent en el espacio de desarrollo a través de los canales de desarrollo, incluyendo API, páginas compartidas, incrustaciones web, componentes de burbuja, LiveDesk y varios canales de mensajería instantánea y telefónica; no incluye la vista previa de depuración en el espacio de desarrollo, Workflow (incluidas las llamadas a la API de Workflow rechazadas por exceso de frecuencia), búsquedas de AI en el espacio de trabajo, ni el uso de agentes publicados en el espacio de trabajo.
• Alcance de los datos: Los datos están disponibles desde 31 días antes del lanzamiento de la función; para períodos anteriores, se usa data_since.
• Frecuencia de actualización: Los datos se cuentan una vez cada hora en punto, con un retraso aproximado de 1 hora, según data_until.
• Diferencia con la página "Organización → Uso → RPM" de la consola: La consola muestra segmentos de 24 horas de un día; esta interfaz devuelve un solo valor máximo para todo el período y el momento en que ocurrió.