Первые шаги с Claude SDK

Начинаем работу с Claude SDK

Начинаем работу с Claude SDK

Цели урока

В этом первом уроке вы узнаете, как: * установить необходимые пакеты и пройти аутентификацию с API * сделать свой первый запрос к ИИ-помощнику Claude

Установка SDK

Прежде чем углубляться в SDK, убедитесь, что у вас установлен Python.

Python SDK для Claude требует Python версии 3.7.1 или новее.

Вы можете проверить текущую версию Python, выполнив следующую команду в терминале:

python --version

Если у вас не установлен Python или ваша версия старше 3.7.1, посетите официальный сайт Python и следуйте инструкциям по установке для вашей операционной системы.

Когда Python готов, вы можете установить пакет Anthropic с помощью pip

# Используйте эту команду, если устанавливаете пакет из ноутбука
%pip install anthropic 
# Используйте эту команду для установки пакета из командной строки
# pip install anthropic

Получение API-ключа

Для аутентификации ваших запросов к Claude API вам понадобится API-ключ.

Выполните следующие шаги для получения вашего API-ключа:

1. Если вы еще не сделали этого, зарегистрируйтесь в аккаунте Anthropic, посетив https://console.anthropic.com
2. После создания аккаунта и входа в систему перейдите на страницу настроек API. Вы можете найти эту страницу, нажав на значок своего профиля в правом верхнем углу и выбрав "API Keys" из выпадающего меню, или перейдя в меню "API Keys" на вкладке Settings.
3. На странице настроек API нажмите кнопку "Create Key". Появится модальное окно, предлагающее вам дать ключу описательное имя. Выберите имя, которое отражает цель или проект, для которого вы будете использовать ключ. Вы можете создать столько ключей, сколько захотите в своем аккаунте (обратите внимание, что лимиты на частоту запросов и сообщений применяются на уровне аккаунта, а не на уровне API-ключа).
4. После ввода имени нажмите кнопку "Create". Ваш новый API-ключ будет сгенерирован и отображен на экране.

   Обязательно скопируйте этот ключ, так как вы не сможете просмотреть его снова после того, как покинете эту страницу.

Помните, ваш API-ключ — это конфиденциальная информация, которая предоставляет доступ к вашей учетной записи Anthropic. Относитесь к нему как к паролю и никогда не делитесь им публично или не сохраняйте его в системах контроля версий, таких как Git.

Безопасное хранение вашего API-ключа

Хотя вы можете жестко закодировать свой API-ключ непосредственно в своих Python-скриптах, общепринятой лучшей практикой является хранение конфиденциальной информации, такой как API-ключи, отдельно от вашей кодовой базы. Один из распространенных подходов — хранить API-ключ в файле .env и загружать его с помощью пакета python-dotenv. Вот как вы можете это настроить:

Создайте новый файл с именем .env в той же директории, что и ваш ноутбук.

Добавьте ваш API-ключ в только что созданный файл .env, используя следующий формат:

ANTHROPIC_API_KEY=put-your-api-key-here

Не забудьте сохранить файл .env

Установите пакет python-dotenv, выполнив следующую команду в вашем терминале или ноутбуке:

# Для установки пакета из ноутбука: 
%pip install python-dotenv

# Для установки пакета из терминала:
# pip install python-dotenv

Теперь мы можем загрузить API-ключ из файла .env, используя функцию load_dotenv() из модуля dotenv со следующим кодом:

from dotenv import load_dotenv
import os

load_dotenv()
my_api_key = os.getenv("ANTHROPIC_API_KEY")

Выполнение базовых запросов с помощью клиента

После установки пакета anthropic и загрузки вашего API-ключа вы готовы начать отправлять запросы к Claude API.

Первый шаг — создать объект клиента, который служит основной точкой входа для взаимодействия с API.

from anthropic import Anthropic

client = Anthropic(
    api_key=my_api_key
)

Обратите внимание, что SDK anthropic автоматически ищет переменную среды с именем "ANTHROPIC_API_KEY", поэтому вам не нужно передавать ее вручную, и вы можете просто сделать следующее:

from anthropic import Anthropic

client = Anthropic()

Теперь, когда наш клиент инстанцирован, пришло время сделать наш первый запрос.

Чтобы отправить сообщение Claude и получить ответ, мы будем использовать метод messages.create() объекта client. Мы поговорим о конкретных параметрах и формате ответа в следующем уроке. А пока попробуйте запустить следующий код, и вы должны получить свое первое сообщение от Claude!

our_first_message = client.messages.create(
    model="claude-3-haiku-20240307",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "Hi there! Please write me a haiku about a pet chicken"}
    ]
)

print(our_first_message.content[0].text)

Feathered friend clucking,
Scratching in the dirt all day,
Loyal pet chicken.

Упражнение

Мы только начали, поэтому это упражнение может показаться немного скромным. Всегда полезно попрактиковаться с основами.

Пожалуйста, выполните следующее: 1. Создайте новый ноутбук или Python-скрипт. 2. Импортируйте нужные пакеты. 3. Загрузите ваш Anthropic API-ключ. 4. Попросите Claude рассказать вам шутку, а затем распечатайте результат (вы можете скопировать/вставить код выше и изменить его).