ВозможностиДокументацияЦеныPlaygroundFAQ

Sessions

Интерактивные сессии с агентами

Обзор

Sessions позволяют создавать интерактивные shell сессии с агентами. Каждая сессия сохраняет свою рабочую директорию и переменные окружения. Sessions интегрируются с MCP для AI-ассистированных взаимодействий.

Возможности

  • •Persistent working directory: Начните с любого места
  • •Environment variables: Установите перед началом сессии
  • •Full shell support: bash, zsh, fish, etc.
  • •MCP integration: AI может выполнять команды в сессиях
  • •Session logs: Полная история команд и вывода

API эндпоинты

bash
# Создать новую сессию
POST /api/v1/sessions
Body: { "agent_id": "my-server", "cwd": "/var/www", "env": { "PATH": "/usr/local/bin:$PATH" } }

# Список сессий
GET /api/v1/sessions

# Получить детали сессии
GET /api/v1/sessions/{id}

# Обновить сессию (cwd, env)
PATCH /api/v1/sessions/{id}

# Закрыть сессию
DELETE /api/v1/sessions/{id}

Модель сессии

bash
{
  "id": "sess_abc123",
  "agent_id": "my-server",
  "cwd": "/var/www/app",
  "env": {
    "PATH": "/usr/local/bin:$PATH",
    "HOME": "/home/user",
    "TERM": "xterm-256color"
  },
  "status": "active",
  "created_at": "2026-04-21T20:00:00Z",
  "last_activity_at": "2026-04-21T20:05:00Z",
  "command_count": 47,
  "output": "Welcome to bash...",
  "log": [
    { "timestamp": "2026-04-21T20:00:00Z", "command": "ls", "status": "success", "output": "app/ logs/" },
    { "timestamp": "2026-04-21T20:00:01Z", "command": "cd app", "status": "success", "output": "" }
  ]
}

Интеграция с MCP

MCP может создавать и управлять сессиями:

bash
// MCP tools/call with session_id
{
  "name": "flowlink_exec",
  "arguments": {
    "agent_id": "my-server",
    "session_id": "sess_abc123",
    "command": "npm run build"
  }
}

Примеры запросов

bash
# Создать сессию в /var/www
curl -X POST https://flowlink.flow-masters.ru/api/v1/sessions \
  -H "Authorization: Bearer flk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "prod-web-01",
    "cwd": "/var/www/app",
    "env": { "NODE_ENV": "production" }
  }'

# Список всех сессий
curl https://flowlink.flow-masters.ru/api/v1/sessions

# Получить детали сессии
curl https://flowlink.flow-masters.ru/api/v1/sessions/sess_abc123

# Закрыть сессию
curl -X DELETE https://flowlink.flow-masters.ru/api/v1/sessions/sess_abc123

Лучшие практики

  • •Всегда указывайте cwd для начала с предсказуемого места
  • •Установите переменные окружения один раз — они сохраняются между командами
  • •Закрывайте сессии когда закончили для освобождения ресурсов
  • •Используйте сессии для длительных задач (сборки, миграции)
← MonitoringSecrets →