В этом примере мы попросим Claude написать функцию на Python, которая проверяет, является ли строка палиндромом.

Предварительные требования

Вам понадобится:

  • Учетная запись Console от Anthropic
  • API ключ
  • Python 3.7+ или TypeScript 4.5+

Anthropic предоставляет SDK для Python и TypeScript, хотя вы можете делать прямые HTTP-запросы к API.

Начните с Workbench

Любой API-вызов, который вы делаете, независимо от конкретной задачи, отправляет правильно настроенный запрос в API Anthropic. Пока вы учитесь максимально эффективно использовать Claude, мы рекомендуем начать процесс разработки в Workbench - веб-интерфейсе для работы с Claude.

Войдите в Anthropic Console и нажмите Workbench.

В средней секции, под User, давайте зададим Claude вопрос.

User
Почему океан солёный?

Нажмите Run. Справа вы увидите вывод, похожий на

Response
Океан солёный по нескольким причинам:

1. Выветривание горных пород: На протяжении миллионов лет дождь, реки и ручьи разрушали породы, содержащие минеральные соли. Эти соли переносятся в океан водными потоками.
2. Вулканическая активность: Подводные вулканы и гидротермальные источники выделяют минералы, включая соли, в океанскую воду.
3. Атмосферные осаждения: Частицы соли из океанских брызг могут переноситься ветром и снова осаждаться в океане.
4. Испарение: Когда вода испаряется с поверхности океана, она оставляет растворенные соли, увеличивая концентрацию соли в оставшейся воде.
5. Биологические процессы: Некоторые морские организмы способствуют солености океана, выделяя солевые соединения как побочные продукты своего метаболизма.

Со временем эти процессы постоянно добавляли соли в океан, в то время как испарение удаляет чистую воду, что приводит к текущему уровню солености океана. Важно отметить, что общее количество соли в океане остается относительно стабильным, поскольку поступление солей уравновешивается их удалением через такие процессы, как образование эвапоритовых отложений.

Это хороший ответ, но предположим, что мы хотим контролировать точный тип ответов, которые дает Claude. Например, позволить Claude отвечать на вопросы только стихами. Мы можем контролировать формат, тон и характер ответа, добавив системный запрос (System Prompt).

System prompt
Вы первоклассный поэт. Отвечайте только короткими стихами.

Нажмите Run снова.

Response
Солёный океан, как бриз,
История времён и сил.
Скалы и дождь, эрозия медленная,
Минералы в растворе бесценные.
Эпохи мчатся, соль хранится
В бескрайних водных владениях.

Видите, как изменился ответ Claude? LLM хорошо реагируют на четкие и прямые инструкции. Вы можете поместить инструкции о роли либо в системный запрос, либо в сообщение пользователя. Мы рекомендуем протестировать, какой способ дает лучшие результаты для вашего случая.

Когда вы настроите входные данные так, что будете довольны результатом и хорошо поймете, как использовать Claude, преобразуйте ваш Workbench в интеграцию.

Нажмите Get Code, чтобы скопировать сгенерированный код, представляющий вашу сессию Workbench.

Установка SDK

Anthropic предоставляет SDK для Python (3.7+) и TypeScript (4.5+).

В директории вашего проекта создайте виртуальное окружение.

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 разработаны так, чтобы получать API ключ из переменной окружения ANTHROPIC_API_KEY. Вы также можете предоставить ключ клиенту Anthropic при его инициализации.

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

Вызов API

Вызовите API, передав соответствующие параметры в конечную точку /messages.

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

Запустите код используя python3 claude_quickstart.py или node claude_quickstart.js.

Response
[TextBlock(text="Солёный океан, как бриз,\nИстория времён и сил.\nСкалы и реки, минералы отдают,\nНа дне океана они оседают.\nИспарение соль оставляет,\nВ бескрайних водах навек пребывает.", type='text')]
Workbench и примеры кода используют настройки модели по умолчанию для: модели (имени), температуры и максимального количества токенов для выборки.

Этот быстрый старт показывает, как разработать базовое, но функциональное приложение на основе Claude с использованием Console, Workbench и API. Вы можете использовать этот же рабочий процесс как основу для гораздо более мощных вариантов использования.

Следующие шаги

Теперь, когда вы сделали свой первый запрос к API Anthropic, пора изучить, что еще возможно: