⚡️ API для ИИ-агента: почему теперь нужно отдавать меньше, а
Недавняя задача: убрать из выдачи метаданные, которые не нужны ИИ-агентам. Под сокращение попали ID записи в журнале запросов, ссылки на неё и на целевой объект, вызываемый метод и ID типа объекта.
Задачу можно решить двумя подходами: Клиент управляет - сам говорит, какие метаданные ему нужны. Сервер управляет - решает, что отдавать клиенту. Я пошёл по второму пути. На практике от систем чаще требуется гибкое управление со стороны сервера, хотя комбинировать оба подхода допустимо. Но самое интересное не в этом.
Раньше мы готовили выдачу под системы и стремились дать больше возможностей. Больше полей, больше ссылок, больше контекста: пусть клиент сам разберётся, что ему нужно.
С приходом ИИ-агентов ситуация перевернулась. Лишние данные не расширяют возможности, а засоряют контекст и тратят ограниченные токены. То, что раньше было «щедростью», теперь стало шумом. Потому что каждый лишний пункт в контексте агента, это потраченный токен и лишний шанс, что он захлебнётся.
Кто уже проектировал API под ИИ-агентов, как решаете, что отдавать, а что резать? Или пока отдаёте всё, а фильтрацию оставляете клиенту? 🤔