Змена архітектуры бэкенду: з фіксаваных API на системы AI-агентаў
Дазвольце дазнацься, як зменяецца дызайн бэкэнда, калі агенты AI заменяюць фіксаваныя маршруты API, з рэальнымі прыкладамі коду, сценарыямі выкарыстоўвання і практычнымі аспектамі, якія трэба взяць у ўвагу.
Дзеўная частка праекта ўжо давно выконвалася па аднам простым прыцэпу: вы насталяваете маршруты, кліент з’яўляецца да іх, а сервер падае адпаведны адказ.
POST /create-order
GET /user/123
Эта модэль чыстая, проста для разумення і добра масштабуецца у працэсе выконання.
Але ёсць адна проблема:
Кожны можлівы шлях у вашай аплікацыі павінен быць заздалегідь запланаваны.
Калі корыстнік прабуе ўчыніць калякво за межамі гэтага плану, рашэнне завжды адно: трэба напісаць больш коду, дадаць больш маршрутаванняў, створыць больш умовных оперэйнаў.
Тепер уявіце сабе іншы тип запиту. Корыстнік проста піша:
„Знайдзіце для мяне самы дагэньшы рейс на завтра і забронюйце яго.“
Не існуе адного канцэнтраўскага пункту, які мог бы выкарыстоўвацца для такой задачы. Самэ тут традыцыйны падход начынае ствараць проблемы.
Як мы будуем ствараць дзеўную частку сёння (API-і)
Разглядзім конкрэтны сценарый.
Алгорытм электронной камеры (на базе API)
// Step 1: Get product
GET /products/:id
// Step 2: Add to cart
POST /cart// Step 3: Create order
POST /order// Step 4: Payment
POST /payment
Кожны з гэтых крокаў ёсць:
- заздалегідь заданы
- явна кантролюемы
- вбудованы ў алгорытм
Нават логіка, якая стоіць за гэтымі маршрутамі, зазвычай выглядае так:
if (user.isLoggedIn) {
createOrder()
} else {
throw new Error("Unauthorized")
}
Гэты падход добра працуе, але ён выклікае певную прыпуск: трэба ўжо знать усі маршруты, якія можа выбраць корыстнік у системе.
Стварэнне той жа функцыяналу з агентам
Уместо таго, каб пераказваць кожны крок, вы описвалі бажаны рэзультат.
"Замовіць найдешавшы iPhone за цену менейшую за ₹70,000"
З такім зменшэнням бэкенд набувае іншага формата.
Крок 1: Адзначыць інструменты (ваашы API)
const tools = [
{
name: "search_products",
description: "Search products by name and filters",
},
{
name: "create_order",
description: "Create order for a product",
},
{
name: "make_payment",
description: "Process payment",
}
]
Акружна паглядзіце, што змянілася.
Тыя ж самыя апіі застаюцца — яны проста выклікаюцца як інструменты.
Шаг 2: Дазвольце агенту самаму прымкнуць рашэнне
За дапамою такой наладкі, як Ollama у поўнай саюзе з Gemma 4:
const userGoal = "Buy the cheapest iPhone under 70000"
const response = await agent.run({
goal: userGoal,
tools
})
Практычна агент сам стараецца рашыць проблему:
- Выклікае
search_products - Фільтруе па цэне
- Выбирае найкращы варыянт
- Выклікае
create_order - Актывае
make_payment
Няма жаднага фіксаванага порядку, напісанага вручную.
Асновная разліка, выказаная проста
Ось гэтае разлікаванне у стислым варыянце:
Апіі:
Вы пішаце:
Step 1 → Step 2 → Step 3
Агенты:
Вы пішаце:
Goal → System figures out steps
Гэтае ўсё сутнасць гэтага перакіду.
Дзе гэта насправды даўа рэзультат
Паглядзім на практычныя сцэнарыі, а не на абстракцыі.
1. Автаматызацыя адказу кліентам
У зменшэньне адоты разлучных канцэнтраў, такіх як:
/get-order/cancel-order/refund
вы дазволяеце системе обрабатваць аднае запыткі, напрыклад:
User: "My order is late, cancel it and refund"
Пасля чаго агент:
- перакантролюе статус замовлення
- анулюе яго
- запускае процэс вярнення грошаў
2. Внутрашняе адзінства для разработчыкаў
Напрыклад:
"Перакантролюйце, чаму затрымка API вырасла за пярэднюю гадзіну"
Агент можа:
- збіраць логі
- перакантролюваць показнікі
- прапанаваць верагодныя прычыны
3. Платформа для пошуку зниклых адзяў
Этот прыклад варта адзначыць.
Пользователь завантажае фота і запытае:
">Знайдзіце, чы гэты чалавек заявлена як зниклы"
Алгорытм дзеяння агента будзе такім:
- званне на службу для параболікаў зялёных
- перагляд базы дадзеных
- выдача знайдзенага параболіка
Нічога з гэтага не выклікае патрэбы ў строгай, заздалега заданай последовасці API.
Як выглядае архітектура
У загальных рысах ёна простая:
User → Agent → Tools → Your Existing Backend
Вашы існуючыя API не зникаюць — вы проста ўкладываеце іх так, каб агент мог уваходзіць у яны за патрэбой.
Прыклад рэалізацыі (у стыле Node.js)
app.post("/tools/create_order", async (req, res) => {
const { productId } = req.body
const order = await createOrder(productId)
res.json(order)
})
Агент проста выклікае гэты канцэнтр как адна з своіх доступных адзінакоў.
Рэальныя вызовы, з якімі даведзецца стаць
Гэты падход не ўжо без труднасцей.
1. Дэбагаванне стае сложней
З традыцыйнымі API вы дэбагуеце свой сапраўдны код.
З агентамі часта даводзіцца дэбагаваць, чаму модель выбрала адпаведную дзеянне.
2. Працэс не завжды ўніверсальны
Той самы логік можа даць разны выхад кожны раз.
3. Выдаткі можа быць быстрая.
Агент можа выконваць 5 вызоў API плюс 10 крокаў аналізу, каб выконаць тое, што ўсё можна было бы зробіць за аднай запыткай.
4. Безпека трэбуе большай увагі.
Патрэбна строгая контроль над тым, якія інструменты можа выкарыстоўваць агент і якія даны з’являюцца ў його распаўзе.
Што гэта значыць для вас як для разраба бэкенду
Не робіце гэта сложней, чым трэба.
Продавайце стваранне API
Яны застаюцца фундаментам, на якім стоіць усё іншае.
Проектавайце сваі API як інструменты, якія можна вызваць
Думайце пра вызначэнні інструмента:
{
"name": "get_user_orders",
"description": "Fetch all orders for a user"
}
Створыце адны маленькі проект агента
Выберыце ўсё, што можна кантролаваць, напрыклад, асистента для замоў, аналізатор логаў чы внутршньага чатбота. Інструменты на кшталт Ollama чы Gemma 4 ўзятыя як разумны пачатак.
Зменіце свае мышленне на адпаведна целям, а не стацыярным прабегам
Такая змена мышлення мае большое значэнне, чым выбор будзь-якога конкретнага інструмента.
Заключныя мыслявы
API-і надаюць системам бэкенду структуру. Агенты даюць ім гнучкасць. Майбутнее — не API проты агентаў, а API плюс агенты. Якщо вы вялікі час ведаеце, як ствараць надзейныя API, вы вже на паловым шляху. Пачніце спытаць ся: а што, як ваш бэкенд зможа сам вырашыць, каліям дзеяць?
Супаўязаныя матэрыялы
- Розумеўце AI-агентаў: цялі, інструменты, память і цикл агента — простае поясненне таго, чым AI-агенты адрозніццаяд чатботамі, з рассказам пра ключовыя складовы, цикл выбору, рэвалюцыі автонаміі і практычныя прыклады ўжывання.