Chargement

Exécution de code et Fichiers API

Leçon 4610 min
Chargement

L'Anthropic API propose deux fonctionnalités puissantes qui fonctionnent exceptionnellement bien ensemble : les Fichiers 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.

Fichiers API

Les Fichiers API offrent un moyen alternatif 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.

Notre serveur envoie à Claude des données d'image brutes et le texte « Que voyez-vous sur cette image ? », et Claude répond « Je vois un grand arbre ».

Voici comment cela fonctionne :

  • Téléchargez votre fichier (image, PDF, texte, etc.) vers Claude à l'aide d'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 futurs messages au lieu d'inclure les données brutes du fichier

Notre serveur envoie l'identifiant de fichier dans un bloc d'image ainsi que « Que voyez-vous sur cette image ? », et Claude répond « Je vois un grand arbre ».

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é.

Notre serveur demande à Claude la valeur de PI jusqu'à la 50e décimale ; Claude renvoie du code, le résultat « 3.1415926535 » et une réponse textuelle.

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

  • S'exécute dans un conteneur Docker isolé
  • Pas d'accès réseau (impossible d'effectuer des 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 les Fichiers API et l'exécution de code

La véritable puissance vient de l'utilisation combinée de ces fonctionnalités. Étant donné que les conteneurs Docker n'ont pas d'accès réseau, les Fichiers API deviennent le principal moyen de faire entrer et sortir des données de l'environnement d'exécution.

Flux de travail détaillé ci-dessous : un message utilisateur avec un bloc de téléchargement vers le conteneur et du texte, puis la réponse de Claude composée de code, de résultats et de texte.

Voici un flux de travail typique :

  1. Téléchargez votre fichier de données (comme un CSV) à l'aide des Fichiers API
  2. Incluez un bloc de téléchargement vers le 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 résultats (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).

Fichier streaming.csv avec des colonnes telles que UserID, SubscriptionTier et TotalViewingHoursLastMonth, et des lignes à partir de USER_00001.

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

python
file_metadata = upload('streaming.csv')

Ensuite, créez 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_20250825", "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 côté serveur - Le code réel que Claude a décidé d'exécuter
  • Blocs de résultat d'outil d'exécution de code - La sortie de l'exécution du code

Réponse affichée : un bloc de texte sur les facteurs de résiliation, un bloc d'utilisation d'outils côté serveur dont le code importe pandas, puis un résultat d'outil.

Claude peut exécuter du code plusieurs fois au cours d'une même réponse, en 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

L'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 au téléchargement. Lorsque Claude crée une visualisation, elle est stockée dans le conteneur et vous pouvez la télécharger à l'aide des Fichiers API.

Recherchez les blocs avec type: "bash_code_execution_output" dans la réponse - ils contiennent des identifiants de fichier pour le contenu généré :

python
download_file("file_id_from_response")

Graphique d'analyse de résiliation multi-panneaux téléchargé : 500 utilisateurs, taux de résiliation de 38,6 %, principal facteur de résiliation : interactions avec le service client.

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 des Fichiers API et de l'exécution de code ouvre de nombreuses possibilités :

  • Traitement et manipulation d'images
  • Analyse syntaxique 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 gardant le contrôle sur les entrées et les sorties grâce aux Fichiers API. Cela crée un flux de travail puissant où Claude devient votre assistant de codage, capable réellement d'exécuter et d'itérer sur des solutions.