msgbyte Intégration avec la compétence Agent
Introduction
La compétence de requête de données Tianji est un ensemble de compétences léger et indépendant des agents qui permet aux agents d'intelligence artificielle (Cursor, Claude Code, Codex, Copilot CLI, etc.) de consulter directement la plateforme Tianji via son OpenAPI en lecture seule.
Elle suit la spécification agentskills.io — un seul fichier SKILL.md avec des fichiers de référence. Pas de processus à long terme, pas de runtime supplémentaire.
:::tip Pour commencer Consultez le Guide d'installation pour une configuration en un clic et manuelle. :::
Ce qu'elle couvre: 69 endpoints GET dans 14 domaines de service :
- Website — statistiques de trafic, pages vues, répartition géographique, rapports Lighthouse
- Monitor — statut de disponibilité, données de vérification récentes, événements de surveillance
- Survey — réponses aux enquêtes, statistiques des résultats, catégories d'IA
- Telemetry — compteurs d'événements personnalisés, vues de page de télémétrie, métriques
- Feed — canaux, flux d'événements, états du flux
- Application — avis sur l'App Store, infos sur les apps, statistiques d'événements
- Billing / AI Gateway / Worker / Page / Workspace / Global / AuditLog
Compétence vs Serveur MCP
Tianji propose deux manières de s'intégrer aux agents d'IA. Choisissez celle qui correspond à votre flux de travail :
| Compétence Agent | Serveur MCP | |
|---|---|---|
| Forme | Fichiers de documentation simple (SKILL.md + références) |
Un processus Node.js à long terme |
| Runtime | Aucun — l'agent utilise curl ou des outils HTTP intégrés |
npx tianji-mcp-server |
| Couverture | 69 endpoints GET (lecture seule, surface complète) | Un sous-ensemble d'outils sélectionnés (lecture + certaines écritures) |
| Configuration | Déposez les fichiers dans le répertoire de compétences de l'agent | Ajoutez la config MCP au fichier de configuration de l'agent |
| Idéal pour | Cursor / Claude Code / Codex / tout agent suivant la spécification agentskills.io | Agents avec un support MCP natif |
Vous pouvez utiliser les deux en même temps sans conflit.
Exemples d'utilisation
Une fois installé, vous pouvez poser des questions en langage naturel à votre agent d'IA et il choisira le bon endpoint :
Exemple 1 : Aperçu du trafic du site web
Utilisateur : Montrez-moi les pages vues de mon site principal au cours des 7 derniers jours.
Agent : [Appelle GET /open/workspace/{workspaceId}/website/all pour trouver le site]
[Puis GET /open/workspace/{workspaceId}/website/{websiteId}/pageviews
avec startAt/endAt couvrant 7 jours]
Votre site principal a reçu 12 438 pages vues au cours des 7 derniers jours,
avec un pic de 2 103 mardi. Source principale : google.com (43%).
Exemple 2 : Vérification de la santé du moniteur
Utilisateur : Est-ce que l'un de mes moniteurs est actuellement en panne ?
Agent : [Appelle GET /open/workspace/{workspaceId}/monitor/all]
[Puis GET /open/workspace/{workspaceId}/monitor/{monitorId}/status
pour chaque moniteur]
2 moniteurs sont actuellement en panne :
- api.example.com (HTTP 503, dernier UP il y a 12 min)
- db-replica (délai d'attente TCP, dernier UP il y a 1h)
Les 8 autres moniteurs sont en bonne santé.
Exemple 3 : Analyse des résultats d'enquête
Utilisateur : Résumez les réponses à l'enquête "Commentaires clients T4".
Agent : [Appelle GET /open/workspace/{workspaceId}/survey/all pour retrouver l'ID]
[Puis GET /open/workspace/{workspaceId}/survey/{surveyId}/stats]
[Puis GET /open/workspace/{workspaceId}/survey/{surveyId}/result/list
avec un curseur de pagination]
"Commentaires clients T4" a reçu 218 réponses. Satisfaction moyenne
de 4,3/5. Thème principal : performance du tableau de bord (mentionné 47 fois).
Fonctionnalité la plus demandée : mode sombre (31 mentions).
Gestion des données sensibles
Certains endpoints peuvent renvoyer des secrets stockés sur la plateforme (par exemple modelApiKey, customModelBaseUrl dans les réponses AI Gateway) ou des informations personnelles identifiables (membres de l'espace de travail, journaux d'audit, facturation).
La compétence instruit les agents de :
- Ne jamais afficher les champs
apiKey,modelApiKey,secret,token,password, oucredential. - Rédiger ou omettre ces champs lors de la synthèse des réponses.
- Pour les membres de l'espace de travail / journaux d'audit, ne présenter que des métadonnées non sensibles (noms, rôles, horodatages) sauf si l'utilisateur demande explicitement tous les détails.
Le openapi-readonly.json inclus rédige aussi ces champs au niveau du schéma, de sorte que les agents ne peuvent pas s'appuyer accidentellement sur leur structure.
Source
La source de la compétence se trouve dans le dépôt Tianji sous skills/tianji-data-query/. Les pull requests sont les bienvenus.