Démarrage rapide

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

Pour suivre ce guide de démarrage rapide, vous avez besoin de :

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

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

​

Commencez avec le Workbench

Tout appel API que vous effectuez - quelle que soit la tâche spécifique - envoie un prompt bien configuré à l’API Anthropic. Lorsque 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 centrale, sous User, 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. L'érosion des roches : Au fil de 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 de l'eau.
2. L'activité volcanique : Les volcans sous-marins et les évents hydrothermaux libèrent des minéraux, y compris des sels, dans l'eau de l'océan.
3. Les dépôts atmosphériques : Les particules de sel provenant des embruns océaniques peuvent être transportées par le vent et redéposées dans l'océan.
4. L'évaporation : Lorsque l'eau s'évapore de la surface de l'océan, elle laisse derrière elle des sels dissous, augmentant la concentration de sel dans l'eau restante.
5. Les processus biologiques : Certains organismes marins contribuent à la salinité de l'océan en libérant des composés salins 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 élimine 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 de sels est équilibré par l'élimination des sels par des processus tels que la formation de dépôts évaporitiques.

C’est une bonne réponse, mais disons que nous voulions contrôler le type exact de réponse que Claude donne. Par exemple, n’autoriser Claude à répondre aux questions que par 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 de courts poèmes.

Cliquez à nouveau sur Run.

La saumure salée de l'océan,
Un conte de temps et d'éléments combinés.
Roches et pluie, une lente érosion,
Minéraux transportés en solution.
Les éons passent, le sel demeure,
Dans le vaste et éternel domaine aquatique.

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 la façon d’utiliser Claude - convertissez votre Workbench en une intégration.

​

Installez 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éfinissez votre clé API

Chaque appel API nécessite une clé API valide. Les SDK sont conçus pour extraire la clé API 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'

​

Appelez 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 définissez la clé API comme une 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-20240620",
    max_tokens=1000,
    temperature=0,
    system="Vous êtes un poète de classe mondiale. Répondez uniquement avec de courts poèmes.",
    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="La saumure salée de l'océan,\nUn conte de temps et de destin.\nRoches et rivières, leurs minéraux déversés,\nS'accumulant dans le lit de l'océan.\nL'évaporation laisse le sel derrière,\nDans les vastes eaux, à jamais enshrined.", type='text')]

Ce guide de démarrage rapide montre comment développer une application de base, 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 effectué votre première requête à l’API Anthropic, il est temps d’explorer ce qui est encore possible :