Claude Academy
載入中

發出請求

第 3 課10 分鐘

現在是時候動手實作 Anthropic Python SDK，並透過 Vertex AI 向 Claude 發出您的第一個請求了。我們將帶您完成三個必要步驟：安裝 SDK、建立用戶端，以及發出您的第一個 API 呼叫。

安裝 Anthropic Python SDK

首先，您需要安裝支援 Vertex AI 的 Anthropic SDK。在您的 Jupyter notebook 中，執行以下魔術指令：

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

[vertex] 部分可確保您取得連接 Google Cloud's Agent Platform 的 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"

您需要將 "your-project-id" 替換為您實際的 Google Cloud 專案 ID，您可以在 Google Cloud Console 的專案選擇器中找到此 ID。將模型設定為變數可以讓您省去在整個 notebook 中重複輸入的麻煩。

了解 Create 函式

向 Claude 發出請求的核心是 create 函式，它需要三個關鍵參數：

已標註的 client.messages.create 呼叫，其中「model」、「max_tokens」設為 1000，以及「messages」參數，說明如下。

  • model - 您想要使用的 Claude 模型名稱
  • max_tokens - 回應長度的安全限制（Claude 不會試圖達到此目標，但它不會超過此限制）
  • messages - 您傳送給 Claude 的對話歷史記錄

可以將 max_tokens 視為一種預算，而非目標。如果您將其設為 1000，Claude 會寫出它認為合適的任何回應，但如果會超過 1000 個 token，它就會停止。

了解 Messages

Messages 代表您與 Claude 之間的來回對話，就像在聊天應用程式中一樣：

聊天視窗，其中使用者訊息詢問「什麼是量子運算？」，而助理訊息則是定義它的 AI 回覆。

訊息有兩種類型：

  • 使用者訊息 - 由人類撰寫，您希望提供給 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 的回應時，您會經常用到這種模式。