Aller au contenu principal

Sorties

Les Sorties structurées vous permettent de définir des schémas JSON que vos agents IA doivent suivre lors de leurs réponses. Cela garantit des réponses cohérentes et lisibles par une machine, faciles à intégrer avec d'autres systèmes, API ou workflows automatisés.

Présentation​

Les Sorties structurées vous permettent de :

  • Définir le format des réponses — Créer des schémas JSON personnalisés pour les réponses des agents
  • Garantir la cohérence — Assurer que les agents retournent toujours les données dans la même structure
  • Faciliter l'intégration — Rendre les réponses facilement exploitables par d'autres systèmes
  • Améliorer l'analyse — Éliminer la nécessité d'un analyse de texte complexe

Fonctionnement​

1. Créer un schéma JSON​

Définissez la structure que votre agent doit suivre :

  • Champs — Spécifiez les champs obligatoires et facultatifs
  • Types de données — Définissez les types (string, number, boolean, array, object)
  • Structures imbriquées — Créez des objets JSON imbriqués complexes
  • Exemples — Fournissez des exemples de valeurs pour plus de clarté

2. Assigner à un agent​

Sélectionnez le schéma de sortie structurée pour votre agent :

  • Onglet Général — Choisissez parmi les sorties structurées disponibles
  • Par agent — Chaque agent peut utiliser un schéma différent
  • Sélection dynamique — Modifiez les schémas selon vos besoins

3. Réponse de l'agent​

Lorsque la fonctionnalité est activée, l'agent :

  • Formate en JSON — Retourne les réponses dans la structure JSON spécifiée
  • Suit le schéma — Inclut tous les champs obligatoires
  • Maintient la structure — Préserve les objets et tableaux imbriqués
  • Valide le format — S'assure que les réponses correspondent au schéma

Créer des sorties structurées​

Étape 1 : Accéder à l'onglet de sortie​

  1. Naviguez vers Agents dans la barre latérale
  2. Sélectionnez un agent ou créez-en un nouveau
  3. Cliquez sur Modifier pour ouvrir le constructeur d'agent
  4. Accédez à l'onglet Output

Étape 2 : Créer un nouveau schéma​

  1. Cliquez sur le bouton Créer un nouveau
  2. Saisissez un titre descriptif pour votre sortie structurée
  3. Utilisez le constructeur JSON pour définir votre schéma

Étape 3 : Définir la structure du schéma​

Utilisez le constructeur JSON visuel pour créer votre schéma :

Structure de base​

{
  "status": "string",
  "message": "string",
  "data": {
    "result": "string"
  }
}

Avec des tableaux​

{
  "items": [
    {
      "id": "string",
      "name": "string",
      "value": "number"
    }
  ],
  "total": "number"
}

Structure complexe imbriquée​

{
  "response": {
    "summary": "string",
    "details": {
      "category": "string",
      "subcategory": "string",
      "metadata": {
        "created_at": "string",
        "updated_at": "string"
      }
    },
    "items": [
      {
        "id": "string",
        "properties": {
          "name": "string",
          "value": "number"
        }
      }
    ]
  }
}

Étape 4 : Enregistrer le schéma​

  1. Cliquez sur Enregistrer pour sauvegarder votre sortie structurée
  2. Le schéma est désormais utilisable dans les agents

Assigner aux agents​

Méthode 1 : Depuis l'onglet Général​

  1. Ouvrez l'agent que vous souhaitez configurer
  2. Accédez à l'onglet Général
  3. Recherchez la section Format de réponse
  4. Sélectionnez votre sortie structurée dans le menu déroulant
  5. Enregistrez l'agent

Méthode 2 : Depuis l'onglet Output​

  1. Ouvrez l'agent que vous souhaitez configurer
  2. Accédez à l'onglet Output
  3. Sélectionnez une sortie structurée dans la liste
  4. L'agent utilisera ce schéma pour toutes ses réponses

Cas d'utilisation​

Intégration API​

Scénario : Vous avez besoin que les réponses de l'agent soient dans un format exploitable par votre API.

Exemple de schéma :

{
  "status": "success",
  "code": 200,
  "data": {
    "result": "string",
    "timestamp": "string"
  }
}

Réponse de l'agent :

{
  "status": "success",
  "code": 200,
  "data": {
    "result": "Task completed successfully",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Extraction de données​

Scénario : Extraire des données structurées à partir de texte non structuré.

Exemple de schéma :

{
  "entities": [
    {
      "type": "string",
      "value": "string",
      "confidence": "number"
    }
  ],
  "summary": "string"
}

Réponse de l'agent :

{
  "entities": [
    {
      "type": "person",
      "value": "John Doe",
      "confidence": 0.95
    },
    {
      "type": "company",
      "value": "TechCorp",
      "confidence": 0.88
    }
  ],
  "summary": "Extracted 2 entities from the text"
}

Rapports formatés​

Scénario : Générer des structures de rapports cohérentes.

Exemple de schéma :

{
  "report": {
    "title": "string",
    "date": "string",
    "sections": [
      {
        "heading": "string",
        "content": "string",
        "metrics": {
          "value": "number",
          "unit": "string"
        }
      }
    ],
    "summary": "string"
  }
}

Automatisation de workflows​

Scénario : Structurer les réponses pour le traitement automatisé des workflows.

Exemple de schéma :

{
  "action": "string",
  "parameters": {
    "key": "value"
  },
  "next_step": "string",
  "metadata": {
    "workflow_id": "string",
    "step_number": "number"
  }
}

Bonnes pratiques​

Conception de schéma​

  1. Soyez précis — Définissez clairement tous les champs et leurs types
  2. Utilisez des exemples — Incluez des exemples de valeurs dans votre schéma
  3. Restez simple — Évitez les structures imbriquées trop complexes lorsque c'est possible
  4. Documentez les champs — Utilisez des noms de champs descriptifs
  5. Considérez les champs facultatifs — Marquez les champs comme facultatifs lorsque c'est approprié

Dénomination des champs​

  • Utilisez des noms clairs — user_name plutôt que un
  • Soyez cohérent — Suivez une convention de nommage (snake_case, camelCase)
  • Évitez les abréviations — Utilisez des mots complets lorsque c'est possible
  • Groupez les champs liés — Utilisez des objets imbriqués pour les données apparentées

Structure du schéma​

  • À plat lorsque c'est possible — Privilégiez les structures plates pour les données simples
  • Imbriquez pour l'organisation — Utilisez l'imbrication pour les données complexes et liées
  • Tableaux pour les listes — Utilisez des tableaux pour les collections d'éléments similaires
  • Objets pour les groupes — Utilisez des objets pour regrouper les champs liés

Tests​

  1. Testez avec des requêtes réelles — Vérifiez que le schéma fonctionne avec des questions d'utilisateurs réelles
  2. Vérifiez tous les champs — Assurez-vous que tous les champs obligatoires sont remplis
  3. Validez les types — Confirmez que les types de données correspondent au schéma
  4. Gérez les cas limites — Testez avec des données inhabituelles ou manquantes

Gestion des sorties structurées​

Afficher tous les schémas​

Dans l'onglet Output, vous pouvez :

  • Lister tous les schémas — Voir toutes les sorties structurées de votre projet
  • Rechercher — Trouver des schémas par nom
  • Trier — Trier par date de création ou par titre
  • Voir les détails — Consulter la structure et les métadonnées du schéma

Modifier des schémas​

  1. Cliquez sur un schéma dans la liste
  2. Modifiez la structure JSON à l'aide du constructeur visuel
  3. Cliquez sur Enregistrer pour mettre à jour le schéma
  4. Les modifications s'appliquent à tous les agents utilisant ce schéma

Supprimer des schémas​

  1. Recherchez le schéma dans la liste
  2. Cliquez sur l'icône Supprimer
  3. Confirmez la suppression
  4. Les agents utilisant ce schéma reviendront à des réponses en texte libre
attention

La suppression d'une sortie structurée affectera tous les agents qui l'utilisent actuellement. Assurez-vous de mettre à jour ces agents avant de procéder à la suppression.

Format des réponses​

Réponse normale (par défaut)​

Lorsqu'aucune sortie structurée n'est sélectionnée, les agents retournent du texte libre :

The user requested information about project status.
The project is currently in progress with 75% completion.
All milestones are on track.

Réponse structurée​

Lorsqu'une sortie structurée est sélectionnée, les agents retournent du JSON :

{
  "status": "in_progress",
  "completion_percentage": 75,
  "milestones": [
    {
      "name": "Phase 1",
      "status": "completed"
    },
    {
      "name": "Phase 2",
      "status": "in_progress"
    }
  ],
  "on_track": true
}

Intégration avec le prompt système​

Lorsqu'une sortie structurée est assignée à un agent :

  1. Schéma inclus — Le schéma JSON est ajouté au prompt système
  2. Instructions de format — L'agent reçoit des instructions de formatage explicites
  3. Exemple fourni — Le schéma sert d'exemple de format
  4. Validation — L'agent tente de reproduire la structure exacte

Fonctionnalités avancées​

Valeurs de champs dynamiques​

Les schémas peuvent inclure des champs qui s'adaptent à la réponse :

{
  "response_type": "string",
  "content": {
    "text": "string",
    "metadata": {}
  }
}

Structures conditionnelles​

Utilisez différents schémas pour différents types de réponses :

{
  "type": "success|error|warning",
  "message": "string",
  "data": {} // Structure varies by type
}

Réponses avec tableaux​

Gérez plusieurs éléments dans les réponses :

{
  "count": "number",
  "items": [
    {
      "id": "string",
      "data": {}
    }
  ]
}

Dépannage​

L'agent ne suit pas le schéma​

Causes possibles :

  • Le schéma n'est pas assigné à l'agent
  • La structure du schéma est trop complexe
  • L'agent a besoin d'instructions plus claires

Solutions :

  • Vérifiez que la sortie structurée est sélectionnée dans l'onglet Général
  • Simplifiez la structure du schéma
  • Ajoutez des descriptions de champs plus explicites
  • Testez d'abord avec des requêtes plus simples

Réponses JSON invalides​

Causes possibles :

  • Le schéma contient des erreurs de syntaxe
  • L'agent éprouve des difficultés avec la structure complexe
  • Des champs obligatoires sont manquants

Solutions :

  • Validez la syntaxe du schéma dans le constructeur JSON
  • Vérifiez les erreurs de validation JSON
  • Simplifiez le schéma s'il est trop complexe
  • Examinez les réponses de l'agent pour détecter des erreurs d'analyse

Champs manquants​

Causes possibles :

  • Les champs ne sont pas clairement définis
  • L'agent ne comprend pas les exigences des champs
  • Le schéma est trop vague

Solutions :

  • Ajoutez des descriptions de champs claires
  • Fournissez des exemples de valeurs dans le schéma
  • Rendez les champs facultatifs s'ils ne sont pas toujours disponibles
  • Testez avec des requêtes spécifiques

Exemples​

Exemple 1 : Réponse du support client​

Schéma :

{
  "ticket_id": "string",
  "status": "open|resolved|pending",
  "response": "string",
  "next_actions": ["string"],
  "priority": "low|medium|high|urgent"
}

Réponse de l'agent :

{
  "ticket_id": "TKT-12345",
  "status": "resolved",
  "response": "Your issue has been resolved. The problem was related to account permissions.",
  "next_actions": ["Refresh your browser", "Log out and log back in"],
  "priority": "medium"
}

Exemple 2 : Réponse d'analyse de données​

Schéma :

{
  "analysis": {
    "summary": "string",
    "findings": [
      {
        "category": "string",
        "insight": "string",
        "confidence": "number"
      }
    ],
    "recommendations": ["string"]
  },
  "data_points": "number"
}

Réponse de l'agent :

{
  "analysis": {
    "summary": "Sales data shows 15% increase in Q4",
    "findings": [
      {
        "category": "revenue",
        "insight": "Revenue increased by 15% compared to Q3",
        "confidence": 0.95
      },
      {
        "category": "customers",
        "insight": "New customer acquisition up 20%",
        "confidence": 0.88
      }
    ],
    "recommendations": [
      "Continue current marketing strategy",
      "Focus on customer retention"
    ]
  },
  "data_points": 1250
}

Exemple 3 : Réponse de gestion des tâches​

Schéma :

{
  "task": {
    "id": "string",
    "title": "string",
    "status": "todo|in_progress|completed",
    "assignee": "string",
    "due_date": "string",
    "description": "string"
  },
  "related_tasks": [
    {
      "id": "string",
      "title": "string"
    }
  ]
}

Permissions​

Création de sorties structurées​

  • Administrateur du projet — Peut créer, modifier et supprimer des sorties structurées
  • Membre du projet — Dépend des permissions du projet (flows.edit)
  • Observateur — Peut consulter mais pas modifier les sorties structurées

Utilisation dans les agents​

  • Propriétaire de l'agent — Peut assigner des sorties structurées à ses agents
  • Administrateur du projet — Peut assigner à n'importe quel agent du projet
  • Membre du projet — Peut assigner aux agents auxquels il a accès

Fonctionnalités associées​

  • Configuration de l'agent — Configurez la personnalité et le comportement de l'agent
  • Outils — Utilisez des outils qui retournent des données structurées
  • Intégration API — Intégrez les réponses structurées avec des API externes
  • Workflows — Utilisez les sorties structurées dans des workflows automatisés
Configuration de l'agent

Découvrez comment configurer vos agents

Support​

Besoin d'aide avec les sorties structurées ? Contactez le support à support@automationanywhere.com.