Текстовые агенты
Текстовые агенты — это инструмент Yandex AI Studio для создания интеллектуальных приложений с поддержкой контекста и внешних интеграций. Такие агенты могут взаимодействовать с пользователем в текстовом виде через чат, формы, API и другие интерфейсы приложений.
На основе текстовых агентов можно создавать простых чат-ботов, сложные интеллектуальные системы поддержки, поисковые и аналитические интерфейсы, а также автоматизировать бизнес-процессы.
Текстовые агенты в AI Studio обладают следующими возможностями:
- ведение диалога с учетом истории переписки и контекста;
- генерация ответов в заданном формате, структурирование данных;
- автоматический вызов инструментов для поиска информации или выполнения действий;
- работа с документами и внутренними данными организации;
- поиск в интернете;
- использование внешних API через MCP-серверы;
- сохранение состояния и памяти между запросами.
Инструменты текстовых агентов
Текстовые агенты могут автоматически вызывать инструменты для расширения своих возможностей.
File Search Tool
Инструмент File Search реализует сценарии RAG (Retrieval Augmented Generation) и позволяет агенту искать информацию в загруженных документах и базах знаний.
С помощью инструмента можно:
- загрузить документы через консоль управления, Files API или Vector Store API;
- создать поисковый индекс на основе загруженных данных;
- использовать найденные фрагменты в ответах агента.
Поисковые индексы хранят информацию в векторном виде и обеспечивают семантический поиск по содержимому документов.
Web Search Tool
Инструмент Web Search позволяет агенту получать актуальную информацию из интернета с использованием поисковой базы Яндекса. Это позволяет обогащать ответы свежими данными и фактами по теме запроса.
С помощью инструмента можно:
- определить до 5 доменов для поиска или использовать глобальный поиск;
- ограничить регион поиска;
- ограничить результаты поиска, чтобы регулировать полноту и детализацию ответов, а также расход токенов.
MCP Tool
MCP Tool используется для подключения текстовых агентов к сторонним API через MCP-серверы.
С помощью инструмента можно:
- настраивать подключения к внешним сервисам и инструментам;
- управлять конфигурациями MCP-серверов;
- отслеживать состояние подключений.
API для создания текстовых агентов
Для разработки текстовых агентов в AI Studio используется Responses API — OpenAI-совместимый API, оптимизированный для текстовых сценариев. Responses API объединяет работу с моделями, инструментами и памятью агента в едином интерфейсе.
Основные возможности Responses API:
- генерация текстовых ответов с учетом контекста;
- автоматический вызов инструментов;
- поддержка RAG-сценариев по локальным данным и веб-поиску;
- форматирование и структурирование ответов;
- работа с любыми доступными моделями AI Studio.
Responses API подходит для большинства текстовых агентских сценариев и является рекомендуемым API для создания текстовых агентов.
Способы создания текстовых агентов
В AI Studio вы можете создавать текстовых агентов несколькими способами:
- в Agent Atelier — для экспериментов и прототипирования;
- с помощью Responses API — для программной интеграции в приложения;
- с использованием Yandex Workflows — для построения сложных сценариев в формате low-code;
- через фреймворки с открытым исходным кодом, совместимые с OpenAI API, например OpenAI SDK, LangChain или LangGraph.
Когда использовать текстовых агентов
Текстовые агенты подходят для решения множества задач, в которых:
- важна точность формулировок и логика ответа;
- требуется работа с документами и базами знаний;
- необходимо получить структурированные данные;
- взаимодействие происходит через текстовые интерфейсы или API;
- не требуется обработка аудио в реальном времени.