prx agent

Выполнение однократного взаимодействия с LLM. Агент обрабатывает один промпт, возвращает ответ и завершает работу. Предназначен для скриптов, конвейеров и интеграции с другими инструментами.

Использование

prx agent [OPTIONS] [PROMPT]

Если PROMPT не указан, ввод считывается из stdin.

Параметры

Флаг	Сокр.	По умолчанию	Описание
--provider	-P	из конфигурации	LLM-провайдер
--model	-m	по умолчанию для провайдера	Идентификатор модели
--system	-s		Пользовательский системный промпт
--file	-f		Прикрепить файл к контексту промпта
--no-tools		false	Отключить использование инструментов
--no-memory		false	Отключить чтение и запись памяти
--json	-j	false	Вывод необработанного JSON-ответа
--temperature	-t	по умолчанию для провайдера	Температура сэмплирования (0.0 - 2.0)
--max-tokens		по умолчанию для провайдера	Максимальное количество токенов ответа
--timeout		120	Таймаут в секундах

Примеры

# Простой вопрос
prx agent "What is the capital of France?"

# Передача содержимого по конвейеру для анализа
cat error.log | prx agent "Summarize these errors"

# Прикрепление файла
prx agent -f report.pdf "Summarize the key findings"

# Использование конкретной модели
prx agent -P anthropic -m claude-sonnet-4-20250514 "Explain quantum entanglement"

# JSON-вывод для скриптов
prx agent --json "List 5 programming languages" | jq '.content'

# Цепочка с другими командами
git diff HEAD~1 | prx agent "Write a commit message for this diff"

Stdin и аргумент

Промпт можно указать как позиционный аргумент или через stdin. Если присутствуют оба, они конкатенируются (сначала содержимое stdin, затем аргумент как инструкция).

# Только аргумент
prx agent "Hello"

# Только stdin
echo "Hello" | prx agent

# Оба: stdin как контекст, аргумент как инструкция
cat data.csv | prx agent "Find anomalies in this dataset"

Файловые вложения

Флаг --file добавляет содержимое файла в контекст промпта. Можно прикрепить несколько файлов:

prx agent -f src/main.rs -f src/lib.rs "Review this code for bugs"

Поддерживаемые типы файлов: текстовые файлы, PDF, изображения (для моделей с поддержкой vision) и распространённые форматы документов.

Коды возврата

Код	Значение
0	Успех
1	Общая ошибка (некорректная конфигурация, сбой сети)
2	Превышен таймаут
3	Ошибка провайдера (ограничение частоты запросов, ошибка аутентификации)

См. также

• prx chat — интерактивный многократный чат
• Обзор провайдеров — поддерживаемые LLM-провайдеры
• Обзор инструментов — доступные инструменты при выполнении агента