Execution de code et API Fichiers : deleguer des taches complexes

L’API Anthropic propose deux fonctionnalites puissantes qui fonctionnent remarquablement bien ensemble : l’API Fichiers (Files API) et l’execution de code (Code Execution). Combinees, elles permettent de deleguer a Claude des taches de calcul et d’analyse complexes.

L’API Fichiers (Files API)

L’API Fichiers offre une alternative a l’encodage base64 direct des fichiers dans vos messages. Le principe :

1. Uploader votre fichier (image, PDF, texte, etc.) vers Claude via un appel API separe
2. Recevoir un objet de metadonnees contenant un identifiant unique du fichier
3. Referencer cet identifiant dans vos messages futurs au lieu d’inclure les donnees brutes

Cette approche est particulierement utile quand :

• Vous voulez referencer le meme fichier dans plusieurs requetes
• Vous travaillez avec des fichiers volumineux qu’il serait penible d’inclure dans chaque requete

L’outil d’execution de code

L’execution de code est un outil cote serveur qui ne necessite aucune implementation de votre part. Vous incluez simplement un schema d’outil predefini dans votre requete, et Claude peut executer du code Python dans un conteneur Docker isole.

Caracteristiques cles de l’environnement d’execution :

• Tourne dans un conteneur Docker isole
• Pas d’acces reseau (impossible de faire des appels API externes)
• Claude peut executer du code plusieurs fois au cours d’une meme conversation
• Les resultats sont captures et interpretes par Claude pour la reponse finale

Combiner les deux : la vraie puissance

La force de cette combinaison vient du fait que les conteneurs Docker n’ont pas d’acces reseau. L’API Fichiers devient donc le moyen principal de faire entrer et sortir des donnees de l’environnement d’execution.

Workflow typique

1. Uploader votre fichier de donnees (ex: un CSV) via l’API Fichiers
2. Inclure un bloc container_upload dans votre message avec l’identifiant du fichier
3. Demander a Claude d’analyser les donnees
4. Claude ecrit et execute du code pour traiter votre fichier
5. Claude peut generer des sorties (graphiques, rapports) que vous pouvez telecharger

Exemple pratique : analyse de donnees streaming

Prenons un cas concret avec un fichier CSV contenant des donnees utilisateurs d’un service de streaming : niveaux d’abonnement, habitudes de visionnage, taux de desabonnement (churn).

Etape 1 : uploader le fichier

file_metadata = upload('streaming.csv')

Etape 2 : creer le message avec le fichier et la demande d’analyse

messages = []
add_user_message(
    messages,
    [
        {
            "type": "text",
            "text": """Effectue une analyse detaillee pour identifier
            les principaux facteurs de desabonnement.
            Ton output final doit inclure au moins un graphique
            detaille resumant tes conclusions."""
        },
        {"type": "container_upload", "file_id": file_metadata.id},
    ],
)

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

Comprendre la reponse

Quand Claude utilise l’execution de code, la reponse contient plusieurs types de blocs :

• Blocs texte : l’analyse et les explications de Claude
• Blocs server_tool_use : le code que Claude a decide d’executer
• Blocs code_execution_result : les sorties de l’execution du code

Claude peut executer du code plusieurs fois dans une meme reponse, en construisant iterativement son analyse. Chaque cycle d’execution comprend le code et ses resultats.

Telecharger les fichiers generes

L’une des fonctionnalites les plus utiles : Claude peut generer des fichiers (graphiques, rapports) et les rendre disponibles au telechargement. Quand Claude cree une visualisation, elle est stockee dans le conteneur et recuperable via l’API Fichiers.

Cherchez les blocs de type code_execution_output dans la reponse — ils contiennent les identifiants des fichiers generes :

download_file("file_id_from_response")

Le resultat : une analyse complete avec des visualisations professionnelles qui aurait demande un effort de codage considerable a faire manuellement.

Au-dela de l’analyse de donnees

La combinaison API Fichiers + execution de code ouvre de nombreuses possibilites :

• Traitement et manipulation d’images
• Parsing et transformation de documents
• Calculs mathematiques et modelisation
• Generation de rapports avec mise en forme personnalisee

L’idee centrale : vous pouvez deleguer des taches computationnelles complexes a Claude tout en gardant le controle sur les entrees et sorties via l’API Fichiers. Claude devient un assistant de programmation capable d’executer et iterer sur des solutions.

Exercice : analyser vos propres donnees

1. Preparez un fichier CSV avec des donnees que vous souhaitez analyser
2. Uploadez-le via l’API Fichiers
3. Demandez a Claude d’effectuer une analyse exploratoire avec au moins un graphique
4. Recuperez le graphique genere via download_file()
5. Experimentez avec des demandes d’analyses de plus en plus specifiques