← Каталог

· AI Engineer Code 2025

Claude Agent SDK: полный практикум

Claude Agent SDK [Full Workshop] — Thariq Shihipar, Anthropic

Агент, который работает через Bash и файловую систему, а не через набор отдельных tools, по словам автора даёт больше гибкости и расходует меньше контекста.

  • Bash как композиционный примитив — один инструмент заменяет набор узких tools: результаты пишутся в файлы, скрипты комбинируются, а модель может сама проверить свою работу. Например, агент для почты находит поездки через grep, суммирует цены и сверяет каждую сумму с исходной строкой.
  • Выбор между tools, Bash и генерацией кода — tools надёжны, но занимают много контекста и плохо комбинируются, а Bash экономит контекст, но агенту нужно время, чтобы узнать доступные команды. Генерация кода самая гибкая, но выполняется дольше и требует линтинга.
  • Таблица как SQL — предложенный из зала приём с SQLite поверх CSV превращает поиск по таблице в запрос, который модель знает хорошо. Так задача переводится в интерфейс, а не в очередной tool.
  • Верификация правилами — по словам автора, чем больше детерминированных проверок, тем лучше: например, Claude Code возвращает ошибку, если агент пишет в файл, который ещё не читал. Hooks позволяют встроить такие проверки в цикл.

Кому полезно: тем, кто строит агентов для задач вне программирования, например анализа данных или работы с документами.

Статья по теме

На какие вопросы отвечает доклад

  • Почему агентам лучше давать Bash и файловую систему, а не набор отдельных инструментов?

    Bash компонуется и занимает мало контекста: вместо десятков инструментов агент пишет скрипты, сохраняет результаты в файлы и проверяет их. Необратимые атомарные действия, например отправку письма, лучше оставлять отдельным инструментам с подтверждением.

    ▶ 15:33Инструмент Bash
  • Как защитить агента, которому разрешены любые Bash-команды?

    По словам спикера, защита многослойная, как «швейцарский сыр»: выравнивание модели, разбор Bash-команд через AST-парсер, разрешения в harness и песочница, которая ограничивает сетевые запросы и запись в файловую систему.

    ▶ 8:08Сильные мнения
  • Как дать агенту доступ к базе: отдельный инструмент или SQL через Bash?

    Для гибких запросов спикер берёт Bash или генерацию кода: модель ошибается в SQL, но исправляет ошибки по выводу и линтеру. Отдельный инструмент оправдан, когда нужно скрыть часть данных и ограничить запись.

    ▶ 25:45Выбор инструментов
  • Как проверять работу агента, если он не может надёжно оценить собственный ответ?

    Проверки нужно ставить на каждом шаге, а начинать с детерминированных правил: линтинг, компиляция, лимиты на объём данных. Например, в Claude Code запись в файл, который агент не читал, отклоняется с ошибкой. Такие проверки можно вешать через hooks.

    ▶ 22:43Агентный цикл
  • Что делать, когда сессия агента становится такой длинной, что ответы ухудшаются?

    Спикер чаще очищает контекст и опирается на состояние в файлах, например на git diff, а не на всю историю диалога. Для пользователей без технических знаний он предлагает сбрасывать диалог на каждый новый вопрос и сохранять их предпочтения.

    ▶ 50:54Проектирование электронных таблиц
  • Стоит ли выносить поиск по большим данным в sub-agents, чтобы не раздувать контекст основного агента?

    Sub-agent выполняет поиск и возвращает основному агенту только итог, поэтому промежуточные результаты в его контекст не попадают. По словам спикера, Claude Code умеет запускать несколько sub-agents параллельно.

    ▶ 50:54Проектирование электронных таблиц

Главы

Ещё доклады: Thariq Shihipar

Страница спикера →

Похожие доклады