Passer au contenu principal

​
Aperçu

Le CLI Nudgen est conçu avec une approche AI-First. Bien qu’il offre un beau TUI pour les humains, chaque commande est optimisée pour la communication machine.

​
Le Modèle Agentique

Lorsqu’un agent IA (comme Claude, GPT ou un agent d’automatisation) utilise le CLI, il doit suivre ces modèles :
  1. Sortie JSON : Ajoutez --json à chaque commande pour obtenir des données exploitables par machine.
  2. Conscience du Contexte : Vérifiez toujours le contexte de l’équipe avant toute opération.
  3. Non interactif : Utilisez des indicateurs pour contourner les invites TUI interactives.

​
Automatisation JSON

Chaque commande de liste et de statut supporte un indicateur --json. Cela renvoie une structure JSON propre au lieu d’un tableau formaté. 
# Obtenir toutes les campagnes en JSON
nudgen campaigns list --json

# Obtenir les contacts de l'équipe actuelle
nudgen contacts list --json

​
Flux de travail Multi-équipes pour Agents

Puisque Nudgen supporte plusieurs équipes, un agent doit s’assurer qu’il opère sur la bonne équipe. Flux de travail recommandé :
  1. Vérifier l’équipe actuelle : 
    nudgen teams current --json
  2. Changer d’équipe (si nécessaire) : Si l’ID ne correspond pas à l’équipe cible : 
    nudgen teams switch <target-team-id>
  3. Exécuter la commande de données : Procéder avec les commandes campaigns, contacts ou brand.

​
Meilleures pratiques pour les développeurs d’agents

  • Gestion des erreurs : Surveillez le code de sortie. Un code non nul indique une erreur (validation, réseau ou auth).
  • Limitation du débit : Le CLI communique avec l’API. Gérez les limites de débit dans vos scripts.
  • Mode silencieux : Si une commande n’offre pas d’indicateur pour chaque invite, assurez-vous que votre agent peut gérer les flux sans rester bloqué.