В этом примере мы попросим 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? Большие языковые модели хорошо реагируют на четкие и прямые инструкции. Вы можете поместить инструкции о роли либо в системный промпт, либо в сообщение пользователя. Мы рекомендуем протестировать, какой способ дает наилучшие результаты для вашего варианта использования.

Как только вы настроили входные данные так, что вы довольны выходными данными и хорошо понимаете, как использовать 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/create.

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

claude_quickstart.py
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.

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

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

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

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

Руководство по инженерии промптов

Оптимизируйте производительность Claude с помощью промптов.

Anthropic Cookbook

Обучайтесь с помощью интерактивных блокнотов Jupyter, демонстрирующих загрузку PDF, эмбеддинги и многое другое.

Библиотека промптов

Изучите десятки примеров промптов для вдохновения в различных вариантах использования.

ОбзорВведение в Claude