Sorties

​

Présentation

• 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

• 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

• 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

• 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

​

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

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

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

​

Extraction de données

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

{
  "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

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

​

Automatisation de workflows

{
  "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

• 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

​

Format des réponses

​

Réponse normale (par défaut)

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

{
  "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

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

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

​

Structures conditionnelles

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

​

Réponses avec tableaux

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

​

Dépannage

​

L’agent ne suit pas le schéma

• 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

• 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

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

• 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

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

• 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

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

{
  "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

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

{
  "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

{
  "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

​

Support