この例では、Claudeに文字列が回文かどうかをチェックするPython関数を書いてもらいます。

前提条件

以下が必要です:

AnthropicはPythonとTypeScript SDKを提供していますが、APIに直接HTTPリクエストを送ることもできます。

Workbenchから始める

APIコールは、特定のタスクに関係なく、適切に設定されたプロンプトをAnthropic APIに送信します。Claudeを最大限に活用する方法を学ぶ際は、開発プロセスをClaudeのウェブベースインターフェースであるWorkbenchから始めることをお勧めします。

Anthropic Consoleにログインし、Workbenchをクリックします。

中央のセクションのUserの下で、Claudeに質問してみましょう。

User
なぜ海は塩辛いのですか?

Runをクリックします。右側に以下のような出力が表示されます:

Response
海が塩辛い理由には、いくつかの要因があります:

1. 岩石の風化:何百万年もかけて、雨、河川、小川が鉱物塩を含む岩石を侵食してきました。これらの塩分は水の流出により海に運ばれます。
2. 火山活動:海底火山や熱水噴出孔が、塩分を含む鉱物を海水中に放出します。
3. 大気沈着:海のしぶきから発生する塩分粒子は、風によって運ばれ、再び海に沈着します。
4. 蒸発:海面から水が蒸発すると、溶解した塩分が残され、残りの水の塩分濃度が高まります。
5. 生物学的プロセス:一部の海洋生物は、代謝の副産物として塩化合物を放出し、海の塩分に寄与しています。

時間とともに、これらのプロセスが継続的に海に塩分を加え、蒸発によって純水が除去されることで、現在の海の塩分濃度となっています。重要な点は、蒸発堆積物の形成などのプロセスによる塩分の除去と、塩分の供給がバランスを保っているため、海の塩分の総量は比較的安定しているということです。

これは良い回答ですが、Claudeが与える回答の正確な種類を制御したいとしましょう。例えば、Claudeに質問への回答を詩でのみ行わせるとします。システムプロンプトを追加することで、応答のフォーマット、トーン、パーソナリティを制御できます。

System prompt
あなたは世界クラスの詩人です。短い詩でのみ応答してください。

もう一度Runをクリックします。

Response
海の塩辛い水よ、
時と元素が織りなす物語。
岩と雨が、ゆっくりと侵食し、
溶液となって鉱物を運ぶ。
永遠に時は流れ、塩は残り、
広大な永遠の水の領域に。

Claudeの応答がどのように変化したかわかりますか?LLMは明確で直接的な指示に良く反応します。役割の指示はシステムプロンプトまたはユーザーメッセージのいずれかに入れることができます。あなたのユースケースに最適な方法をテストすることをお勧めします。

出力に満足し、Claudeの使い方を十分に理解したら、Workbenchをインテグレーションに変換します。

Get Codeをクリックして、Workbenchセッションを表す生成されたコードをコピーします。

SDKのインストール

AnthropicはPython(3.7+)とTypeScript(4.5+)用のSDKを提供しています。

プロジェクトディレクトリで仮想環境を作成します。

Python
python -m venv claude-env

以下を使用して仮想環境を有効化します

  • macOSまたはLinuxの場合、source claude-env/bin/activate
  • Windowsの場合、claude-env\Scripts\activate
Python
pip install anthropic

APIキーの設定

すべてのAPIコールには有効なAPIキーが必要です。SDKは環境変数ANTHROPIC_API_KEYからAPIキーを取得するように設計されています。また、Anthropicクライアントの初期化時にキーを提供することもできます。

export ANTHROPIC_API_KEY='your-api-key-here'

APIの呼び出し

適切なパラメータを/messages/createエンドポイントに渡してAPIを呼び出します。

Workbenchが提供するコードではコンストラクタでAPIキーを設定していることに注意してください。APIキーを環境変数として設定した場合は、以下のようにその行を省略できます。

claude_quickstart.py
import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1000,
    temperature=0,
    system="あなたは世界クラスの詩人です。短い詩でのみ応答してください。",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "なぜ海は塩辛いのですか?"
                }
            ]
        }
    ]
)
print(message.content)

python3 claude_quickstart.pyまたはnode claude_quickstart.jsを使用してコードを実行します。

Response
[TextBlock(text="海の塩辛い水よ、\n時と設計の物語。\n岩と川がその鉱物を流し、\n海底に蓄積される。\n蒸発は塩を残し、\n広大な水に永遠に刻まれる。", type='text')]
Workbenchとコードサンプルでは、モデル(名前)、温度、サンプリングする最大トークン数のデフォルト設定を使用しています。

このクイックスタートでは、Console、Workbench、APIを使用して、基本的ながら機能的なClaude搭載アプリケーションを開発する方法を示しました。この同じワークフローを、より強力なユースケースの基礎として使用できます。

次のステップ

最初のAnthropic APIリクエストを作成したので、他に何が可能か探索する時が来ました: