Passer au contenu principal

​
Paramètres supportés

Plusieurs paramètres sont disponibles pour mieux répondre à vos besoins, qui doivent être ajoutés dans votre charge utile de requête :
  • guided_choice : la sortie sera exactement l’un des choix proposés.
  • guided_regex : la sortie suivra le modèle regex.
  • guided_json : la sortie suivra le schéma JSON.
Les sections suivantes vous donneront des exemples sur la façon d’utiliser chacun de ces paramètres.

​
Choix Guidés

Utilisez le paramètre guided_choice pour forcer un modèle à choisir l’une des options que vous définissez.
Voici un exemple ci-dessous. 
import requests
import os

paradigm_api_key = os.environ.get("PARADIGM_API_KEY", None)

url = "https://paradigm.lighton.ai/api/v2/chat/completions"
headers = {
    "Authorization": f"Bearer {paradigm_api_key}",
    "Content-Type": "application/json",
}
payload = {
    "model": "alfred-4.2",
    "messages": [
        {"role": "user", "content": "Classifiez ce sentiment : Alfred est merveilleux !"}
    ],
    "guided_choice": ["positif", "négatif"]
}
response = requests.post(url, json=payload, headers=headers)
data = response.json()

print(data["choices"][0]["message"]["content"])
Pour cet exemple, la sortie devrait afficher le texte positif.

​
Regex Guidée

Utilisez le paramètre guided_regex pour générer du texte suivant un modèle regex.
Voici un exemple ci-dessous. 
import requests
import os

paradigm_api_key = os.environ.get("PARADIGM_API_KEY", None)

url = "https://paradigm.lighton.ai/api/v2/chat/completions"
headers = {
    "Authorization": f"Bearer {paradigm_api_key}",
    "Content-Type": "application/json",
}
payload = {
    "model": "alfred-4.2",
    "messages": [
        {
            "role": "user",
            "content": "Générez un exemple d'adresse email pour Alan Turing, qui travaille chez Enigma. Terminez par .com. Exemple de résultat : alan.turing@enigma.com\n"
        }
    ],
    "guided_regex": r"\w+@\w+\.com",
}
response = requests.post(url, json=payload, headers=headers)
data = response.json()

print(data["choices"][0]["message"]["content"])
La sortie devrait alors suggérer une adresse email suivant le modèle regex comme alan_turing@enigma.com par exemple.

​

Intégrité et Validation des DonnéesLe schéma JSON maintient une haute qualité des données en appliquant une structure prédéfinie et des règles de validation, minimisant le besoin de vérifications supplémentaires.

​
Créez votre Schéma JSON

Vous avez 2 possibilités pour créer votre schéma JSON :

​
Le Rôle des Séquences d’Arrêt

Les séquences d’arrêt sont essentielles dans les tâches de données structurées, marquant la fin des réponses du modèle pour maintenir les sorties dans la structure de votre schéma.
Séquence d’Arrêt ObligatoireUtilisez toujours une séquence d’arrêt appropriée d’un modèle (par défaut pour mistral c’est stop=["</s>"]) pour garantir une terminaison précise de la sortie du modèle, en l’alignant avec votre schéma JSON.

​
Exemple de code

Les exemples suivants montrent comment utiliser le paramètre guided_json avec un schéma JSON explicite ainsi qu’avec un modèle Pydantic. 
import requests
import json
import os

# Récupérer la clé API Paradigm depuis l'environnement
paradigm_api_key = os.environ.get("PARADIGM_API_KEY", None)

# Définir le schéma JSON pour la génération de données
json_schema = """{
  "$defs": {
    "CarType": {
      "enum": [
        "berline",
        "SUV",
        "Camion",
        "Coupé"
      ],
      "title": "CarType",
      "type": "string"
    }
  },
  "properties": {
    "marque": {
      "title": "Marque",
      "type": "string"
    },
    "modele": {
      "title": "Modèle",
      "type": "string"
    },
    "type_voiture": {
      "$ref": "#/$defs/CarType"
    }
  },
  "required": [
    "marque",
    "modele",
    "type_voiture"
  ],
  "title": "DescriptionVoiture",
  "type": "object"
}"""

url = "https://paradigm.lighton.ai/api/v2/chat/completions"
headers = {
    "Authorization": f"Bearer {paradigm_api_key}",
    "Content-Type": "application/json",
}
payload = {
    "model": "alfred-4.2",
    "messages": [
        {
            "role": "user",
            "content": "Générez un JSON avec la marque, le modèle et le type_voiture de la voiture la plus emblématique des années 80",
        }
    ],
    "guided_json": json_schema
}
response = requests.post(url, json=payload, headers=headers)
response_data = response.json()

print(json.dumps(json.loads(response_data["choices"][0]["message"]["content"]), indent=2))

from pydantic import BaseModel
from enum import Enum
import requests
import json
import os

paradigm_api_key = os.environ.get("PARADIGM_API_KEY", None)

class TypeVoiture(str, Enum):
    berline = "berline"
    suv = "SUV"
    camion = "Camion"
    coupe = "Coupé"

class DescriptionVoiture(BaseModel):
    marque: str
    modele: str
    type_voiture: TypeVoiture

json_schema = DescriptionVoiture.model_json_schema()

url = "https://paradigm.lighton.ai/api/v2/chat/completions"
headers = {
    "Authorization": f"Bearer {paradigm_api_key}",
    "Content-Type": "application/json",
}
payload = {
    "model": "alfred-4.2",
    "messages": [
        {
            "role": "user",
            "content": "Générez un JSON avec la marque, le modèle et le type_voiture de la voiture la plus emblématique des années 80",
        }
    ],
    "guided_json": json_schema
}
response = requests.post(url, json=payload, headers=headers)
response_data = response.json()

print(json.dumps(json.loads(response_data["choices"][0]["message"]["content"]), indent=2))
Voici un exemple de sortie que vous pouvez obtenir :
{
  "marque": "Delorean",
  "modele": "DMC-12",
  "type_voiture": "berline"
}
Exploiter la Correspondance de ModèlesUtilisez l’attribut pattern dans le schéma JSON pour définir des expressions régulières (regex) pour faire correspondre des formats de texte spécifiques. La regex (.+) est particulièrement utile pour capturer des segments de texte variés, permettant une extraction précise des informations souhaitées à partir de textes. Cette fonctionnalité est essentielle pour analyser des points de données spécifiques à partir de texte non structuré ou semi-structuré.

​
Utilisation des Données Extraites

Exploitez les données structurées de vos extractions pour enrichir les bases de données, les systèmes CRM, ou automatiser les flux de travail, améliorant ainsi l’efficacité opérationnelle.
Correspondance de Modèles PréciseVérifiez que les modèles regex de votre schéma JSON s’alignent avec les formats attendus de votre texte. Des incompatibilités peuvent entraîner des erreurs d’extraction de données ou des inexactitudes.En utilisant le schéma JSON, vous pouvez transformer efficacement du texte non structuré en données structurées et exploitables, offrant une solution évolutive pour vos besoins de traitement de données.

​
Conclusion

Les sorties structurées enrichissent l’expérience utilisateur avec un contenu détaillé et garantissent la cohérence des données à l’échelle de l’application. C’est crucial pour les applications qui dépendent de l’intégrité des données structurées.
Pièges Courants
  • L’exclusion de propriétés de schéma nécessaires peut entraîner des sorties de données partielles.
  • L’imposition de contraintes trop strictes peut restreindre la capacité de l’IA à produire du contenu pertinent.
  • Négliger d’inclure des séquences d’arrêt dans les appels API peut causer des problèmes de traitement.