読み込み中

リクエストを送信する

レッスン 310 分
読み込み中

いよいよAnthropic Python SDKを実際に使って、Vertex AI経由でClaudeに初めてのリクエストを送信する時が来ました。ここでは、SDKのインストール、クライアントの作成、最初のAPI呼び出しという3つの重要なステップを順に見ていきます。

Anthropic Python SDKのインストール

まず、Vertex AIサポート付きのAnthropic SDKをインストールする必要があります。Jupyterノートブックで、次のマジックコマンドを実行してください。

bash
%pip install "anthropic[vertex]<1"

[vertex]の部分によって、Google CloudのVertex AIプラットフォームへの接続に必要な特定のコンポーネントが確実に取得されます。

APIクライアントの作成

次に、Vertex AI専用に設計されたクライアントインスタンスをインポートして作成します。

python
from anthropic import AnthropicVertex

client = AnthropicVertex(region="global", project_id="your-project-id")
model = "claude-haiku-4-5@20251001"

このモデルとパッケージのバージョンはコース全体を通して維持してください。より新しいバージョンでは、temperatureや事前入力されたアシスタントメッセージなど、後のレッスンで学ぶ設定が拒否されてしまいます。

"your-project-id"の部分は、実際のGoogle CloudプロジェクトIDに置き換える必要があります。このIDはGoogle Cloud Consoleのプロジェクトセレクターで確認できます。モデルを変数として設定しておくと、ノートブック全体で繰り返し入力する手間が省けます。

create関数を理解する

Claudeへのリクエストを行う上で中心となるのがcreate関数で、3つの主要なパラメータを必要とします。

「model」「max_tokens」(1000に設定)、「messages」パラメータを注釈付きで示したclient.messages.create呼び出し。詳細は以下を参照。

  • model - 使用したいClaudeモデルの名前
  • max_tokens - 応答の長さに対する安全上の上限(Claudeはこの値に到達しようとはしませんが、これを超えることはありません)
  • messages - Claudeに送信する会話履歴

max_tokensは目標値ではなく、予算のようなものだと考えてください。1000に設定した場合、Claudeは適切だと判断した応答を書きますが、1000トークンを超えそうになると途中で止まります。

メッセージを理解する

メッセージは、チャットアプリケーションと同じように、あなたとClaudeとの間で交わされるやり取りの会話を表します。

ユーザーメッセージが「量子コンピューティングとは何ですか?」と尋ね、アシスタントメッセージがその定義を答えているチャットウィンドウ。

メッセージには2つの種類があります。

  • ユーザーメッセージ - Claudeに渡したい、人間が書いたコンテンツ
  • アシスタントメッセージ - Claudeが生成して返してきたコンテンツ

最初のリクエストを送信する

基本的なリクエストの組み立て方は次のとおりです。

python
message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

各メッセージは、role(「user」または「assistant」)とcontent(実際のテキスト)を持つ辞書です。

レスポンスからテキストを抽出する

リクエストを実行すると、多数のメタデータを含む複雑なレスポンスオブジェクトが返ってきます。Claudeが生成したテキストだけを取得するには、次のようにします。

python
message.content[0].text

これにより、技術的な詳細をすべて含む完全なレスポンスオブジェクトの代わりに、すっきりとした読みやすい出力が得られます。Claudeのレスポンスを扱う際には、このパターンを頻繁に使用することになります。