Текстовые агенты

Текстовые агенты — это инструмент Yandex AI Studio для создания интеллектуальных приложений с поддержкой контекста и внешних интеграций. Такие агенты могут взаимодействовать с пользователем в текстовом виде через чат, формы, API и другие интерфейсы приложений.

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

Текстовые агенты в AI Studio обладают следующими возможностями:

• ведение диалога с учетом истории переписки и контекста;
• генерация ответов в заданном формате, структурирование данных;
• автоматический вызов инструментов для поиска информации или выполнения действий;
• работа с документами и внутренними данными организации;
• поиск в интернете;
• использование внешних API через MCP-серверы;
• сохранение состояния и памяти между запросами.

Инструменты текстовых агентовИнструменты текстовых агентов

Текстовые агенты могут автоматически вызывать инструменты для расширения своих возможностей.

File Search ToolFile Search Tool

Инструмент File Search реализует сценарии RAG (Retrieval Augmented Generation) и позволяет агенту искать информацию в загруженных документах и базах знаний.

С помощью инструмента можно:

• загрузить документы через консоль управления, Files API или Vector Store API;
• создать поисковый индекс на основе загруженных данных;
• использовать найденные фрагменты в ответах агента.

Поисковые индексы хранят информацию в векторном виде и обеспечивают семантический поиск по содержимому документов.

Web Search ToolWeb Search Tool

Инструмент Web Search позволяет агенту получать актуальную информацию из интернета с использованием поисковой базы Яндекса. Это позволяет обогащать ответы свежими данными и фактами по теме запроса.

С помощью инструмента можно:

• определить до 5 доменов для поиска или использовать глобальный поиск;
• ограничить регион поиска;
• ограничить результаты поиска, чтобы регулировать полноту и детализацию ответов, а также расход токенов.

MCP ToolMCP Tool

MCP Tool используется для подключения текстовых агентов к сторонним API через MCP-серверы.

С помощью инструмента можно:

• настраивать подключения к внешним сервисам и инструментам;
• управлять конфигурациями MCP-серверов;
• отслеживать состояние подключений.

API для создания текстовых агентов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;
• не требуется обработка аудио в реальном времени.