API Elasticsearch : ce qu'elle permet et comment l'utiliser avec des agents IA
Elasticsearch est un moteur de recherche et d'analyse doté d'une API REST pour indexer des documents, rechercher, agréger et administrer le cluster. Il sert aux équipes d'ingénierie, d'observabilité et produit pour la recherche, les logs et les métriques. L'accès se fait par une clé d'API ou un utilisateur dont les rôles sont définis dans le cluster lui-même.
Ce que propose l’API Elasticsearch
Index
Création, mappings et paramètres des index.
Documents
Ajout, mise à jour et suppression de documents, aussi par lots.
Recherche
Requêtes textuelles, filtres et tri avec la Query DSL.
Agrégations
Comptages, moyennes et distributions sur les données.
Recherche vectorielle
Recherche par similarité avec des vecteurs, dans les versions qui la prennent en charge.
Santé du cluster
État des nœuds, des shards et des index.
Comment accéder à l’API Elasticsearch
- Avec les identifiants de votre entrepriseClé d'API, ou utilisateur et mot de passe avec des rôles Elasticsearch qui limitent index et actions ; sur Elastic Cloud, l'endpoint est celui du déploiement.
- Les requêtes lourdes peuvent affecter le cluster : fixez des limites de durée et de taille.
- Les logs peuvent contenir des données personnelles ou des secrets (RGPD).
- Restreignez la clé par index plutôt que de donner un accès global.
Documentation officielle: www.elastic.co/guide/en/elasticsearch/reference/current/rest-apis.html
Ce qu’un agent iTeam fait avec l’API Elasticsearch
Enquête sur une erreur en production
Quand une alerte se déclenche, l'agent cherche dans les logs le motif d'erreur, agrège par service et par version, et résume pour l'astreinte.
Question sur le comportement d'un client
Le support demande ce qu'un utilisateur a fait avant l'erreur, et l'agent consulte les événements indexés de cette session.
Cluster en jaune
L'agent vérifie la santé du cluster et indique quels index ont des shards non alloués.
Recherche du site améliorée
L'agent analyse les recherches sans résultat et suggère des synonymes à l'équipe produit.
De l’identifiant à l’agent au travail, avec validation
Créez une clé d'API restreinte
Limitez la clé aux index nécessaires et à la lecture seule, lorsque c'est possible.
Enregistrez-la dans le coffre iTeam
La clé et l'endpoint restent dans le coffre, avec un accès réseau approuvé par l'IT.
Testez avec validation
Les écritures, les suppressions et les changements d'index passent par une validation humaine.
Équipes IA prêtes à l’emploi pour ce travail
Reporting de direction
Les chiffres des ventes, de la finance et des opérations sont rassemblés, vérifiés et commentés en clair avant votre réunion de direction.
Analyse de données
Posez une question métier dans Slack ou Teams : l'équipe écrit la requête, vérifie le résultat et vous répond avec le chiffre et sa source.
Support informatique interne
Mot de passe, accès, matériel : la demande est posée dans Slack ou Teams, l'agent répond ou ouvre un ticket Jira complet.
Questions sur l’API Elasticsearch
L'API Elasticsearch est-elle gratuite ?
Cela dépend : Elasticsearch a une distribution gratuite pour un usage propre, tandis qu'Elastic Cloud et les fonctions avancées sont payants selon l'abonnement.
Faut-il programmer pour utiliser l'API Elasticsearch avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation, et l'équipe de déploiement configure les requêtes avec votre équipe.
Cela fonctionne-t-il avec OpenSearch ?
Beaucoup d'appels sont proches, mais pas identiques ; iTeam s'appuie sur la documentation du système que vous utilisez.