Agent SDK

Agent SDK

• Обзор Agent SDK: Создавайте производственные AI-агентов с Claude Code как библиотеку
• Быстрый старт: Начните работу с Python или TypeScript Agent SDK для создания AI-агентов, которые работают автономно

Основные концепции

• Как работает цикл агента: Поймите жизненный цикл сообщений, выполнение инструментов, контекстное окно и архитектуру, которые питают ваших агентов SDK.
• Использование функций Claude Code в SDK: Загружайте инструкции проекта, skills, hooks и другие функции Claude Code в ваши SDK-агентов.
• Работа с сеансами: Как сеансы сохраняют историю разговора агента, и когда использовать continue, resume и fork для возврата к предыдущему запуску.
• Сохранение сеансов во внешнее хранилище: Зеркалируйте стенограммы сеансов в S3, Redis или собственный бэкенд, чтобы другие хосты могли возобновить ваши сеансы.

Ввод и вывод

• Streaming Input: Понимание двух режимов ввода для Claude Agent SDK и когда использовать каждый
• Обработка одобрений и пользовательского ввода: Выводите запросы на одобрение Claude и уточняющие вопросы пользователям, а затем возвращайте их решения в SDK.
• Потоковая передача ответов в реальном времени: Получайте ответы в реальном времени от Agent SDK по мере поступления текста и вызовов инструментов
• Получение структурированного вывода от агентов: Возвращайте валидированный JSON из рабочих процессов агентов, используя JSON Schema, Zod или Pydantic. Получайте типобезопасные структурированные данные после многоходового использования инструментов.

Расширить с помощью инструментов

• Предоставьте Claude пользовательские инструменты: Определите пользовательские инструменты с помощью встроенного MCP-сервера Agent SDK, чтобы Claude мог вызывать ваши функции, обращаться к вашим API и выполнять операции, специфичные для вашей области.
• Подключение к внешним инструментам с помощью MCP: Настройте MCP серверы для расширения вашего агента внешними инструментами. Охватывает типы транспорта, поиск инструментов для больших наборов инструментов, аутентификацию и обработку ошибок.
• Масштабирование на множество инструментов с помощью поиска инструментов: Масштабируйте вашего агента на тысячи инструментов, обнаруживая и загружая только необходимое по требованию.
• Subagents в SDK: Определяйте и вызывайте subagents для изоляции контекста, параллельного выполнения задач и применения специализированных инструкций в приложениях Claude Agent SDK.

Настройка поведения

• Изменение системных подсказок: Выберите между предустановкой claude_code и пользовательской системной подсказкой, и настройте поведение с помощью CLAUDE.md, стилей вывода, append или полностью пользовательской подсказки.
• Расширьте агентов с помощью skills: Управляйте тем, какие skills может вызывать Claude в сеансах Claude Agent SDK, отправляйте команды по имени и создавайте skills, которые обнаруживают ваши сеансы
• Plugins в SDK: Загружайте пользовательские plugins для расширения Claude Code с помощью skills, agents, hooks и MCP серверов через Agent SDK

Управление и наблюдаемость

• Настройка разрешений: Контролируйте использование инструментов вашим агентом с помощью режимов разрешений, hooks и декларативных правил allow/deny.
• Перехватывайте и контролируйте поведение агента с помощью hooks: Перехватывайте и настраивайте поведение агента в ключевых точках выполнения с помощью hooks
• Отмотка изменений файлов с помощью checkpointing: Отслеживайте изменения файлов во время сеансов агента и восстанавливайте файлы в любое предыдущее состояние
• Отслеживание затрат и использования: Узнайте, как отслеживать использование токенов, оценивать затраты и настраивать кэширование подсказок с помощью Claude Agent SDK.
• Наблюдаемость с OpenTelemetry: Экспортируйте трассировки, метрики и события из Agent SDK в ваш бэкенд наблюдаемости с помощью OpenTelemetry.
• Отслеживание задач: Отслеживайте задачи в сеансах Agent SDK и отображайте прогресс Claude в вашем приложении с помощью структурированных вызовов инструментов

Развертывание

• Размещение Agent SDK: Развертывание Agent SDK в production: архитектура подпроцессов, сохранение сеансов, масштабирование, наблюдаемость и изоляция нескольких арендаторов для Docker, Kubernetes и поставщиков песочниц.
• Безопасное развертывание AI-агентов: Руководство по защите развертываний Claude Code и Agent SDK с использованием изоляции, управления учетными данными и сетевых элементов управления

Справочные материалы SDK

• Справочник Agent SDK - TypeScript: Полный справочник API для TypeScript Agent SDK, включая все функции, типы и интерфейсы.
• TypeScript SDK V2 session API (removed): Справочник по удалённому V2 TypeScript Agent SDK session API с паттернами отправки/потока на основе сессий для многооборотных разговоров.
• Справочник Agent SDK - Python: Полный справочник API для Python Agent SDK, включая все функции, типы и классы.
• Миграция на Claude Agent SDK: Руководство по миграции Claude Code TypeScript и Python SDK на Claude Agent SDK