Obtenir le RPM de pointe d'un Agent

Obtenez le RPM de pointe (nombre de requêtes par minute) d'un Agent pendant une plage de temps, tout en renvoyant le moment où le pic a eu lieu, le RPM moyen et le nombre total de requêtes.

Remarque : vous pouvez interroger des données sur un maximum de 31 jours ; seules les chaînes de l'espace de développement sont comptées, la portée de la statistique est indiquée ci-dessous dans « Critères de statistique ».

Méthode de requête

GET

URL d'appel

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

Authentification de l'appel

Utilisez l'authentification Basic avec DevKey / DevSecret au niveau du compte : Authorization: Basic ${BASIC_TOKEN}, où ${BASIC_TOKEN} est l'encodage Base64 de DevKey:DevSecret.

• Le compte appelant doit être membre de l'organisation correspondant à org_id et avoir l'autorisation « Voir l'utilisation » (les propriétaires et administrateurs de l'organisation l'ont par défaut), et doit également pouvoir voir cet Agent : le créateur de l'Agent, le propriétaire de l'organisation, ou un membre à qui l'autorisation sur cet Agent (ou tous les Agents) a été accordée.
• Veuillez appeler l'URL du centre de données de l'organisation, ${endpoint} doit prendre region renvoyé par Liste des organisations (SG → sg, TH → th, JP → jp). Appeler un autre centre de données renverra « pas membre de cette organisation ».

Fréquence d'appel

• Chaque clé de développeur peut appeler cette API jusqu'à 60 fois par minute.
• Chaque appel compte également dans le quota « API statistique » de l'organisation par minute, partagé avec les appels d'API statistique avec la clé Agent API.
• Les données sont mises à jour toutes les heures ; pour la même heure, les requêtes répétées renvoient le même résultat, il est recommandé d'appeler une fois par heure.

Requête

Exemple de requête

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

                    

En-tête de requête

Paramètres de requête

Réponse

Exemple de réponse

                      
                      {
    "code": 0,
    "message": "OK",
    "data": {
        "agent_id": "65f0c2a1b4e8d93a1c7e5b21",
        "range_start": 1788192000000,
        "range_end": 1788796800000,
        "data_until": 1788793200000,
        "peak_rpm": 42,
        "peak_at": 1788512460000,
        "avg_rpm": 3.18,
        "total_requests": 18234
    }
}

                    

Réponse réussie

Réponse échouée

Codes d'erreur

Le code de statut HTTP correspond aux trois premiers chiffres du code d'erreur, par exemple 40000 correspond à 400, 40100 correspond à 401, 403132 correspond à 403.

Méthodologie des statistiques

• Requêtes : messages de questions envoyés par l’utilisateur, y compris les erreurs de conversation (y compris celles refusées en raison d’une fréquence d’appel dépassée), cohérents avec « Agent Insights → Requêtes par minute » du tableau de bord. Ce n’est pas le nombre de requêtes HTTP et peut différer du comptage des limitations du forfait.
• Portée des statistiques : seules les canaux de l’espace développeur sont comptés, y compris API, page de partage, intégration web, composants en bulle, LiveDesk, ainsi que tous les canaux de messagerie instantanée et téléphonie ; ne comprend pas l’aperçu de débogage dans l’espace développeur, l’exécution de Workflow, ni l’utilisation de l’Agent après sa publication dans l’espace de travail.
• Fréquence de mise à jour : les données sont comptées chaque heure pile, avec un délai d’environ 1 heure, basé sur data_until. Les données avant le 09-03-2026 ne contiennent pas de détails au niveau minute, le résultat de la requête étant 0.