Configuration initiale

Dans cet exemple, nous allons demander à Claude d’écrire une fonction Python qui vérifie si une chaîne de caractères est un palindrome.

​

Prérequis

Vous aurez besoin de :

• Un compte Anthropic Console
• Une clé API
• Python 3.7+ ou TypeScript 4.5+

Anthropic fournit des SDK Python et TypeScript, bien que vous puissiez faire des requêtes HTTP directes à l’API.

​

Commencer avec le Workbench

Chaque appel API que vous faites—quelle que soit la tâche spécifique—envoie un prompt bien configuré à l’API Anthropic. Pendant que vous apprenez à tirer le meilleur parti de Claude, nous vous recommandons de commencer le processus de développement dans le Workbench, une interface web pour Claude.

Connectez-vous à la Console Anthropic et cliquez sur Workbench.

Dans la section du milieu, sous Utilisateur, posons une question à Claude.

Pourquoi l'océan est-il salé ?

Cliquez sur Run. Sur le côté droit, vous verrez une sortie comme

L'océan est salé en raison de plusieurs facteurs :

1. Érosion des roches : Au fil des millions d'années, la pluie, les rivières et les ruisseaux ont érodé les roches contenant des sels minéraux. Ces sels sont transportés dans l'océan par le ruissellement.
2. Activité volcanique : Les volcans sous-marins et les sources hydrothermales libèrent des minéraux, y compris des sels, dans l'eau de l'océan.
3. Dépôt atmosphérique : Les particules de sel provenant des embruns marins peuvent être transportées par le vent et déposées à nouveau dans l'océan.
4. Évaporation : Lorsque l'eau s'évapore de la surface de l'océan, elle laisse derrière elle des sels dissous, augmentant la concentration en sel dans l'eau restante.
5. Processus biologiques : Certains organismes marins contribuent à la salinité de l'océan en libérant des composés salés comme sous-produits de leur métabolisme.

Au fil du temps, ces processus ont continuellement ajouté des sels à l'océan, tandis que l'évaporation retire l'eau pure, conduisant aux niveaux actuels de salinité de l'océan. Il est important de noter que la quantité totale de sel dans l'océan reste relativement stable car l'apport en sels est équilibré par l'élimination des sels à travers des processus comme la formation de dépôts d'évaporites.

C’est une bonne réponse, mais disons que nous voulions contrôler le type exact de réponse que Claude donne. Par exemple, en permettant à Claude de répondre aux questions uniquement avec des poèmes. Nous pouvons contrôler le format, le ton et la personnalité de la réponse en ajoutant un System Prompt.

Vous êtes un poète de classe mondiale. Répondez uniquement avec des poèmes courts.

Cliquez à nouveau sur Run.

L'océan salé, mystérieux,
Un conte du temps précieux.
Roches et pluie, lente érosion,
Minéraux en dissolution.
Les éons passent, le sel demeure,
Dans le vaste domaine aqueux qui perdure.

Voyez-vous comment la réponse de Claude a changé ? Les LLM répondent bien aux instructions claires et directes. Vous pouvez mettre les instructions de rôle soit dans le prompt système, soit dans le message utilisateur. Nous vous recommandons de tester pour voir quelle méthode donne les meilleurs résultats pour votre cas d’utilisation.

Une fois que vous avez ajusté les entrées de manière à être satisfait de la sortie—et que vous avez une bonne idée de comment utiliser Claude—convertissez votre Workbench en une intégration.

​

Installer le SDK

Anthropic fournit des SDK pour Python (3.7+) et TypeScript (4.5+).

• Python
• TypeScript

python -m venv claude-env

pip install anthropic

​

Définir votre clé API

Chaque appel API nécessite une clé API valide. Les SDK sont conçus pour récupérer la clé API à partir d’une variable d’environnement ANTHROPIC_API_KEY. Vous pouvez également fournir la clé au client Anthropic lors de son initialisation.

• macOS et Linux
• Windows

export ANTHROPIC_API_KEY='votre-clé-api-ici'

​

Appeler l’API

Appelez l’API en passant les paramètres appropriés au point de terminaison /messages/create.

Notez que le code fourni par le Workbench définit la clé API dans le constructeur. Si vous avez défini la clé API comme variable d’environnement, vous pouvez omettre cette ligne comme ci-dessous.

• Python
• TypeScript

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1000,
    temperature=0,
    system="Vous êtes un poète de classe mondiale. Répondez uniquement avec des poèmes courts.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Pourquoi l'océan est-il salé ?"
                }
            ]
        }
    ]
)
print(message.content)

Exécutez le code en utilisant python3 claude_quickstart.py ou node claude_quickstart.js.

[TextBlock(text="L'océan salé, mystérieux,\nUn conte du temps précieux.\nRoches et rivières, leurs minéraux versés,\nS'accumulant dans les fonds marins creusés.\nL'évaporation laisse le sel derrière,\nDans les vastes eaux, pour toujours prisonnière.", type='text')]

Ce guide de démarrage rapide montre comment développer une application basique mais fonctionnelle alimentée par Claude en utilisant la Console, le Workbench et l’API. Vous pouvez utiliser ce même flux de travail comme base pour des cas d’utilisation beaucoup plus puissants.

​

Prochaines étapes

Maintenant que vous avez fait votre première requête API Anthropic, il est temps d’explorer ce qui est possible :