Бизнес функция - деятельность, которую мы описываем. Название всегда будет глаголом или глагольным оборотом: «Подписать договор», «Проконтролировать качество упаковки», «Перевезти посылку»

Название = Действие + Объект + Уточнение(если они нужны)

Мы выбираем «Подобрать», а не просто «Найти» или «Сканировать», потому что агент выполняет сложную когнитивную работу: он не просто делает запрос в базу (как поисковик), а итеративно сканирует каталог, фильтрует результаты в памяти и валидирует их на соответствие нечетким критериям пользователя.

Пример: «Нужна игровая видеокарта не дороже 60000 рублей, желательно Asus».

Мы осознанно не упоминаем в механизмах LLM, так как это больше НФТ (нефункциональное требование), нежели бизнес-требование.

Важно: мы не отбираем у исследователей работу с промптом, но указываем в требованиях общие рекомендации.

Рекомендую сразу размышлять над негативными сценариями: как мы будем обрабатывать ошибки.

Помоги мне настроить VPS, чтобы запускать кодингового агента – проведи меня за ручку по всем важным этапам, а там где можешь выполнять команды самостоятельно (в т.ч. через SSH), делай это (но гранулярно, без огромных скриптов)

Требования:

Базовая настройка:

- Новый пользователь agent с sudo без пароля, чтобы агент мог сам запускать sudo-команды без интерактивного режима
- Доступ по ssh-ключу к новому пользователю agent (заранее сгенерируй ssh-ключи локально)
- Доступ к root-пользователю должен быть закрыт. Доступ по паролю – тоже
- Файерволл и fail2ban

Дополнительные настройки:

- Адекватная настройка bash history
- Swap 2GB
- Caddy
- uv для python и bun для javascript – через install.sh скрипты (найди в интернете)
- Docker + Compose v2 (добавить agent в группу docker)

ВАЖНО:

- Во время работы ты не должен получать доступ к секретам (пароль VPS, приватный ssh ключ, etc)
- Если что-то требует ввода секретных данных, то проси меня делать вручную
- В остальных случаях старайся использовать non-interactive режим, чтобы я участвовал в процессе минимально
- Задавай уточняющие вопросы, если есть что-то, что не прописано явно

ssh agent "printf '%s\n' 'ВСТАВЛЯЕМ СЮДА КЛЮЧ' >> ~/.ssh/authorized_keys"

curl -fsSL https://claude.ai/install.sh | bash

tools:
  list_directory_tool:
    base_class: "tools.ListDirectoryTool"
  read_file_tool:
    base_class: "tools.ReadFileTool"
  search_in_files_tool:
    base_class: "tools.SearchInFilesTool"

IMG_PATH="chart.png"
MIME="image/png"
IMG_B64="$(base64 -w 0 "$IMG_PATH")"

curl -X POST "http://localhost:8010/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sgr-agent",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "Analyze this chart and research the trends shown"},
        {"type": "image_url", "image_url": {"url": "data:'"$MIME"';base64,'"$IMG_B64"'"}}
      ]
    }],
    "stream": true,
    "temperature": 0.4,
    "max_tokens": 1500
  }'

# Качаем образ
docker pull ghcr.io/vamplabai/sgr-agent-core:latest

# Запускаем контейнер
docker run -d \
  --name sgr-agent-backend \
  -p 8010:8010 \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  -v $(pwd)/agents.yaml:/app/agents.yaml:ro \
  -v $(pwd)/logs:/app/logs \
  -v $(pwd)/reports:/app/reports \
  ghcr.io/vamplabai/sgr-agent-core:latest