Claude Academy
Chargement

Exécution de code et Files API

Leçon 4610 min

L'API Anthropic propose deux fonctionnalités puissantes qui fonctionnent exceptionnellement bien ensemble : la Files API et l'exécution de code. Bien qu'elles puissent sembler distinctes à première vue, leur combinaison ouvre des possibilités vraiment intéressantes pour déléguer des tâches complexes à Claude.

Files API

La Files API offre une manière alternative de gérer les téléchargements de fichiers. Au lieu d'encoder des images ou des PDF directement dans vos messages sous forme de données base64, vous pouvez télécharger des fichiers à l'avance et les référencer ultérieurement.

Voici comment cela fonctionne :

  • Téléchargez votre fichier (image, PDF, texte, etc.) vers Claude via un appel API distinct
  • Recevez un objet de métadonnées de fichier contenant un identifiant de fichier unique
  • Référencez cet identifiant de fichier dans les messages futurs au lieu d'inclure les données brutes du fichier

Cette approche est particulièrement utile lorsque vous souhaitez référencer le même fichier plusieurs fois ou lorsque vous travaillez avec des fichiers volumineux qu'il serait fastidieux d'inclure dans chaque requête.

Outil d'exécution de code

L'exécution de code est un outil côté serveur qui ne nécessite pas que vous fournissiez une implémentation. Vous incluez simplement un schéma d'outil prédéfini dans votre requête, et Claude peut éventuellement exécuter du code Python dans un conteneur Docker isolé.

Caractéristiques clés de l'environnement d'exécution de code :

  • S'exécute dans un conteneur Docker isolé
  • Aucun accès réseau (ne peut pas effectuer d'appels API externes)
  • Claude peut exécuter du code plusieurs fois au cours d'une même conversation
  • Les résultats sont capturés et interprétés par Claude pour la réponse finale

Combiner la Files API et l'exécution de code

La véritable puissance vient de l'utilisation conjointe de ces fonctionnalités. Comme les conteneurs Docker n'ont pas d'accès réseau, la Files API devient le principal moyen de faire entrer et sortir des données de l'environnement d'exécution.

Voici un flux de travail typique :

  1. Téléchargez votre fichier de données (comme un CSV) en utilisant la Files API
  2. Incluez un bloc de téléchargement de conteneur dans votre message avec l'identifiant de fichier
  3. Demandez à Claude d'analyser les données
  4. Claude écrit et exécute du code pour traiter votre fichier
  5. Claude peut générer des sorties (comme des graphiques) que vous pouvez télécharger

Exemple pratique

Examinons un exemple réel utilisant des données de service de streaming. Le fichier CSV contient des informations sur les utilisateurs, notamment les niveaux d'abonnement, les habitudes de visionnage, et s'ils ont résilié (annulé leur abonnement).

Tout d'abord, téléchargez le fichier à l'aide d'une fonction d'assistance :

python
file_metadata = upload('streaming.csv')

Créez ensuite un message qui inclut à la fois le fichier téléchargé et une demande d'analyse :

python
messages = []
add_user_message(
    messages,
    [
        {
            "type": "text",
            "text": """Run a detailed analysis to determine major drivers of churn.
            Your final output should include at least one detailed plot summarizing your findings."""
        },
        {"type": "container_upload", "file_id": file_metadata.id},
    ],
)

chat(
    messages,
    tools=[{"type": "code_execution_20250522", "name": "code_execution"}]
)

Comprendre la réponse

Lorsque Claude utilise l'exécution de code, la réponse contient plusieurs types de blocs :

  • Blocs de texte - L'analyse et les explications de Claude
  • Blocs d'utilisation d'outils serveur - Le code réel que Claude a décidé d'exécuter
  • Blocs de résultats d'outils d'exécution de code - La sortie de l'exécution du code

Claude peut exécuter du code plusieurs fois au cours d'une même réponse, construisant son analyse de manière itérative. Chaque cycle d'exécution inclut le code et ses résultats.

Télécharger les fichiers générés

Une des fonctionnalités les plus puissantes est la capacité de Claude à générer des fichiers (comme des graphiques ou des rapports) et à les rendre disponibles pour téléchargement. Lorsque Claude crée une visualisation, elle est stockée dans le conteneur et vous pouvez la télécharger en utilisant la Files API.

Recherchez les blocs avec type: "code_execution_output" dans la réponse - ceux-ci contiennent les identifiants de fichiers pour le contenu généré :

python
download_file("file_id_from_response")

Le résultat est une analyse complète avec des visualisations professionnelles qui auraient nécessité un codage manuel considérable pour être produites.

Au-delà de l'analyse de données

Bien que l'analyse de données soit un cas d'usage naturel, la combinaison de la Files API et de l'exécution de code ouvre de nombreuses possibilités :

  • Traitement et manipulation d'images
  • Analyse et transformation de documents
  • Calculs mathématiques et modélisation
  • Génération de rapports avec mise en forme personnalisée

L'essentiel est que vous pouvez déléguer des tâches complexes et computationnelles à Claude tout en conservant le contrôle sur les entrées et les sorties via la Files API. Cela crée un flux de travail puissant où Claude devient votre assistant de codage, capable d'exécuter et d'itérer réellement sur des solutions.