Начальная настройка

В этом примере мы попросим 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 вопрос.

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

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

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

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

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

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

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

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

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

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

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

​

Установка SDK

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

• Python
• TypeScript

python -m venv claude-env

pip install anthropic

​

Установите ваш API ключ

Каждый API-вызов требует действительного API-ключа. SDK разработаны так, чтобы получать API-ключ из переменной окружения ANTHROPIC_API_KEY. Вы также можете предоставить ключ клиенту Anthropic при его инициализации.

• macOS and Linux
• Windows

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

​

Вызов API

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

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

• Python
• TypeScript

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    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')]

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

​

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

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