Создайте AI‑агента за минуты с Vercel Eve – открытый фреймворк

Что такое eve и зачем он нужен?

Vercel выпустил eve — открытый фреймворк для создания, запуска и масштабирования интеллектуальных агентов. Пакет eve доступен в npm под лицензией Apache‑2.0.

Главная идея : агент — это не код‑хаос, а чётко описанная директория. Вам больше не придётся собирать «трубопроводы», которые обычно требуются для продакшн‑развёртывания. Всё, что нужно — это набор файлов, а eve автоматически подхватит их и «соединит».

Структура проекта: агент как файловая система

Каждый агент представляет собой папку. Содержимое папки полностью описывает его поведение.

Добавить новый инструмент, навык или канал — просто создать файл в нужной папке. eve «подхватит» его во время сборки, без необходимости писать регистрацию вручную.

Минимальный рабочий пример

// agent/agent.ts
import { defineAgent } from "eve";

export default defineAgent({
  model: "anthropic/claude-opus-4.8",
});

Вместе с файлом instructions.md такой агент уже готов к запуску. В instructions.md пишем обычный markdown‑промпт, который будет предшествовать каждому запросу модели.

Что уже включено в eve «из коробки»

• Durable execution — каждый диалог сохраняется в виде workflow‑снимков, что позволяет паузить работу, переживать сбои и восстанавливать её после деплоя.
• Sandboxed compute — любой код, генерируемый агентом, исполняется в изолированном контейнере (Docker, Vercel Sandbox или простом bash‑сандбоксе).
• Human‑in‑the‑loop approvals — любые «опасные» действия могут требовать подтверждения от человека; процесс приостанавливается без затрат вычислительных ресурсов.
• Secure connections — хранение токенов и URL‑ов в файлах connections/; модель никогда не видит секретов.
• Channels — один агент обслуживает сразу несколько интерфейсов (HTTP, Slack, Discord, Teams, Telegram, Twilio, GitHub, Linear).
• Tracing & evals — автоматически формируются OpenTelemetry‑спаны, которые можно отправлять в Braintrust, Honeycomb, Datadog или Jaeger. Тестовые наборы (evals) позволяют проверять агента в CI.

Практические сценарии

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

• Data analyst (d0) — агент, отвечающий на запросы к базе данных (30 000 вопросов/мес). Каждый запрос автоматически ограничивается правами пользователя.
• Автономный SDR (Lead Agent) — собирает лиды, пишет письма и сопровождает их. Стоимость ≈ 5 000 $/год, выгода ≈ 32×.
• Sales cockpit (Athena) — без кода за 6 недель выводит метрики из Snowflake и Salesforce на естественном языке.
• Support engineer (Vertex) — обрабатывает 92 % тикетов без участия человека, эскалирует только сложные.
• Content reviewer (draft0) — проверяет статьи перед публикацией, автоматически исправляет типичные ошибки.
• Routing bot (V) — в Slack принимает запросы и перенаправляет их к нужному агенту.

Как быстро начать

1. Установите пакет: npm i -D eve.
2. Создайте директорию agent/ и добавьте минимум два файла: agent.ts и instructions.md.
3. Определите хотя бы один инструмент в tools/ (например, запрос к базе run_sql.ts).
4. Запустите локальный сервер: npx eve dev. Вы сразу получите HTTP‑эндпоинт и, при желании, eve channels add slack — чтобы получать запросы из Slack.
5. Для продакшн‑развёртывания используйте vercel (Vercel автоматически собирает ваш агент и публикует его как сервер‑лес).

Типичные подводные камни и как их избежать

• Слишком громоздкие навыки. Храните только ту информацию, которая реально нужна в данном контексте. skills/ подгружаются по требованию, так что не забрасывайте в них десятки страниц.
• Неочищенные sandbox‑файлы. При работе с временными скриптами регулярно очищайте sandbox/, иначе размер образа будет расти.
• Отсутствие approvals. Любые операции, которые могут изменить данные (INSERT, UPDATE, DELETE), сразу отмечайте needsApproval: true. Это спасёт от случайных «апокалипсисов» в продакшне.
• Неправильные права доступа к connections. Проверьте, что токены хранятся в переменных окружения и не попадают в репозиторий.

Заключение

Фреймворк eve снимает большую часть операционного бремени при создании интеллектуальных агентов. Вы описываете «что» в виде файлов, а eve заботится о «как» — от изоляции до масштабирования и мониторинга. Если вам нужны надёжные боты, которые могут самостоятельно отвечать на запросы, выполнять скрипты и работать в разных каналах, eve предоставляет готовый набор инструментов, проверенный в реальном продакшне Vercel.