Guides
Lire les résultats
Les onglets de la page d'exécution, les scores et comment exporter ou servir la version gagnante.
La page d'une exécution affiche sa progression et ses résultats. Ce guide présente les onglets de la page d'exécution, les scores, et la manière d'exporter ou de servir la meilleure version.
Onglets de la page d'exécution
La page d'exécution n'affiche que les onglets qui s'appliquent à l'exécution. Certains onglets dépendent du parcours, du statut et de votre niveau d'expérience.
| Onglet | Quand il s'affiche | Ce qu'il contient |
|---|---|---|
| Aperçu | Toujours | La progression, les scores et l'historique des scores |
| Utilisation | Une exécution réussie avec un programme que Skynet peut servir | Un formulaire pour exécuter le programme optimisé, et du code d'intégration |
| Artefact | Une exécution Prompt, Code ou Texte qui a un résultat | Les versions de votre artefact, avec la meilleure version |
| Données | Une exécution de programme DSPy terminée | Les données réparties en ensembles d'entraînement, de validation et de test, et l'évaluation du jeu de test |
| Code | Quand l'exécution a du code à afficher | Le code d'exécution et la métrique |
| Récompense | Une exécution Prompt, Code ou Texte dont la métrique déclare des composantes de récompense | Les composantes de la récompense et leurs poids |
| Artefact | Une exécution avec un prompt ou des fichiers optimisés | La sortie optimisée et Exporter les résultats |
| Journaux | La plupart des exécutions | Le journal de l'exécution |
| Utilisation et coût | Quand vous êtes connecté | Ce que l'exécution a dépensé |
| Exécution planifiée | Une exécution Prompt, Code ou Texte réussie | Une planification pour relancer l'optimisation |
| Configuration | Toujours | La configuration de l'exécution |
Scores
Skynet sélectionne les versions sur les cas de validation. Il indique le score final sur les cas de test. Les moteurs ne voient jamais les cas de test. Lisez Jeux de données et répartitions.
L'onglet Aperçu affiche :
- Amélioration : l'évolution entre la version de départ et la meilleure version.
- Progression du score : le score au fil de l'exécution.
- Détail du score : chaque métrique, avec les colonnes Référence, Optimisé et Évolution.
Pendant que l'exécution est active, l'aperçu affiche aussi Écoulé, Restant et Débit.
Pour une exécution Prompt, Code ou Texte, l'aperçu affiche aussi Scores nommés quand votre métrique renvoie des scores nommés.
Pour une exécution de programme DSPy, l'onglet Données comporte une Évaluation du jeu de test. Elle affiche le score de référence et le score optimisé pour chaque cas de test.
Quand la meilleure version est la version de départ
Il arrive qu'aucun candidat ne batte la version de départ. Skynet renvoie alors la version de départ. L'onglet Artefact vous indique qu'une protection contre la régression a été appliquée.
Si l'exécution s'est arrêtée à son budget, la page d'exécution vous indique quelle version Skynet a enregistrée. Lisez Exécutions.
Exporter la meilleure version
Exécutions Prompt, Code et Texte
L'onglet Artefact liste les Versions de votre artefact. Pour chaque version, vous pouvez :
- Copier la version.
- Télécharger la version sous forme de fichier.
- Pour une exécution sur un dépôt, télécharger la version sous forme d'archive zip du dépôt complet.
Vous pouvez comparer une version avec une autre. L'onglet affiche aussi le Retour de l'évaluateur pour une version.
Exécutions de programme DSPy
L'onglet Artefact comporte un panneau Exporter les résultats. Ouvrez le menu Télécharger. Il affiche les formats disponibles pour l'exécution :
| Option | Format |
|---|---|
| Programme DSPy | .zip, un export autonome que vous pouvez exécuter |
| Programme optimisé | .pkl |
| Prompt | .json |
| Code optimisé | .py |
| Journaux | .csv |
Servir la meilleure version
Vous pouvez appeler un programme DSPy optimisé depuis votre propre code. L'onglet Utilisation comporte deux parties :
- Un formulaire. Saisissez les champs d'entrée et sélectionnez Exécuter pour obtenir une prédiction.
- Du Code d'intégration en cURL, Python, JavaScript, Go et DSPy.
Le programme s'exécute toujours avec les paramètres de modèle avec lesquels il a été optimisé. Vous devez fournir tous les champs d'entrée. Skynet ignore les champs supplémentaires.
Pour appeler le programme, créez un jeton d'API dans Paramètres → API. Puis envoyez une requête :
export APP_API_TOKEN=skyd_...
curl -X POST "$API_URL/serve/<optimization_id>" \
-H "Authorization: Bearer $APP_API_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"inputs": {"question": "What is DSPy?"}}'import os
import uuid
import requests
response = requests.post(
f"{os.environ['API_URL']}/serve/<optimization_id>",
headers={
"Authorization": f"Bearer {os.environ['APP_API_TOKEN']}",
"Idempotency-Key": str(uuid.uuid4()),
},
json={"inputs": {"question": "What is DSPy?"}},
)
print(response.json()["outputs"])Remplacez question par les champs d'entrée de votre programme. Le Code d'intégration de l'onglet Utilisation renseigne pour vous l'URL réelle et les noms des champs.
La réponse contient outputs, les input_fields, les output_fields et le model_used.
Pour recevoir les sorties partielles au fur et à mesure, envoyez la même requête à /serve/<optimization_id>/stream. La réponse est un flux d'événements envoyés par le serveur (server-sent events).
Lisez API pour l'authentification et les autres points de terminaison.
Partager les résultats
Vous pouvez partager une exécution avec d'autres personnes, ou la publier dans la galerie publique Explorer. Lisez Partager et publier.