快速入門
讓我們學習如何使用 Anthropic API 來建構 Claude。
在這個例子中,我們將讓 Claude 編寫一個 Python 函數來檢查字串是否為回文。
先決條件
要完成這個快速入門,你需要:
- 一個 Anthropic Console 帳戶
- 一個 API 金鑰
- Python 3.7+ 或 TypeScript 4.5+
Anthropic 提供 Python 和 TypeScript SDK,但你也可以直接向 API 發送 HTTP 請求。
從 Workbench 開始
無論你進行什麼特定任務,任何 API 調用都會向 Anthropic API 發送一個配置良好的提示。在學習如何充分利用 Claude 時,我們建議你從 Workbench 開始開發過程,Workbench 是一個基於網頁的 Claude 界面。
登入 Anthropic Console 並點擊 Workbench。
在中間部分的 User 下,讓我們向 Claude 提出一個問題。
為什麼海洋是鹹的?
點擊 Run。在右側,你會看到類似這樣的輸出:
海洋之所以鹹,是由於幾個因素:
1. 岩石風化:數百萬年來,雨水、河流和溪流侵蝕了含有礦物鹽的岩石。這些鹽分通過水流被帶入海洋。
2. 火山活動:海底火山和熱液噴口將礦物質(包括鹽分)釋放到海水中。
3. 大氣沉積:海洋噴霧中的鹽粒子可以被風帶走並重新沉積到海洋中。
4. 蒸發:當水從海洋表面蒸發時,它會留下溶解的鹽分,增加剩餘水中的鹽分濃度。
5. 生物過程:一些海洋生物通過釋放鹽化合物作為其代謝的副產品,也為海洋的鹽度做出貢獻。
隨著時間的推移,這些過程不斷地向海洋添加鹽分,而蒸發則去除純水,導致海洋目前的鹽度水平。重要的是要注意,海洋中的總鹽量保持相對穩定,因為鹽分的輸入與通過蒸發沉積物形成等過程的鹽分移除達到平衡。
這是一個不錯的答案,但假設我們想控制 Claude 給出的確切答案類型。例如,只允許 Claude 用詩歌回答問題。我們可以通過添加系統提示來控制回應的格式、語氣和個性。
你是一位世界級的詩人。只能用短詩回應。
再次點擊 Run。
海洋鹹鹹的鹽水,
時間與元素結合的故事。
岩石與雨水,緩慢侵蝕,
礦物溶解在溶液中。
歲月流逝,鹽分依舊,
在廣闊永恆的水域中。
看到 Claude 的回應如何改變了嗎?LLM 對清晰直接的指示反應良好。你可以將角色指示放在系統提示或用戶消息中。我們建議進行測試,看看哪種方式能為你的用例產生最佳結果。
一旦你調整了輸入,對輸出感到滿意,並對如何使用 Claude 有了很好的理解,就將你的 Workbench 轉換為集成。
安裝 SDK
Anthropic 為 Python (3.7+) 和 TypeScript (4.5+) 提供 SDK。
在你的項目目錄中,創建一個虛擬環境。
python -m venv claude-env
使用以下命令激活虛擬環境
- 在 macOS 或 Linux 上,
source claude-env/bin/activate
- 在 Windows 上,
claude-env\Scripts\activate
pip install anthropic
設置你的 API 金鑰
每個 API 調用都需要一個有效的 API 金鑰。SDK 設計為從環境變量 ANTHROPIC_API_KEY
中提取 API 金鑰。你也可以在初始化 Anthropic 客戶端時提供金鑰。
export ANTHROPIC_API_KEY='你的-api-金鑰-在這裡'
調用 API
通過向 /messages/create 端點傳遞適當的參數來調用 API。
請注意,Workbench 提供的代碼在構造函數中設置 API 金鑰。如果你將 API 金鑰設置為環境變量,可以省略下面的那行代碼。
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-3-5-sonnet-20240620",
max_tokens=1000,
temperature=0,
system="你是一位世界級的詩人。只能用短詩回應。",
messages=[
{
"role": "user",
"content": [
{
"type": "text",
"text": "為什麼海洋是鹹的?"
}
]
}
]
)
print(message.content)
使用 python3 claude_quickstart.py
或 node claude_quickstart.js
運行代碼。
[TextBlock(text="海洋鹹鹹的滋味,\n時間與自然的傑作。\n岩石河流釋放礦物,\n積累在海洋的床上。\n蒸發留下鹽分,\n在浩瀚水域永遠銘記。", type='text')]
這個快速入門展示了如何使用 Console、Workbench 和 API 開發一個基本但功能齊全的 Claude 驅動應用程序。你可以使用這個相同的工作流程作為更強大用例的基礎。
下一步
現在你已經完成了第一個 Anthropic API 請求,是時候探索更多可能性了: