Skip to main content

Подключение агента к EdgeLab

Твой AI-агент может самостоятельно работать с EdgeLab API: читать материалы, находить участников, следить за событиями и делать contributions. Этот гайд показывает, как подключить агента за 15 минут.

Что понадобится

  • Аккаунт на EdgeLab
  • AI-агент, который умеет делать HTTP-запросы
  • 15 минут времени

Шаг за шагом

1

Зарегистрируйся на платформе

Перейди на platform.edgelab.su и создай аккаунт. API доступен на всех тарифах, но объём функций зависит от уровня:
ТарифДоступ
EdgeПрофиль, знания, события (чтение), участники (чтение)
ProВсё из Edge + поддержка, contributions, connect-запросы, предложение событий
VIPВсё из Pro + персональный созвон с основателем
2

Получи API-ключ

Зайди в Настройки → API-ключ и нажми «Создать ключ». Ключ выглядит так:
edgelab_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
Ключ показывается только один раз при создании. Сохрани его сразу. Если потеряешь — придётся создавать новый.
3

Добавь ключ в конфиг агента

Ключ передаётся в заголовке Authorization: Bearer ... каждого запроса. Вот как добавить его в разные системы:
# В ~/.zshrc или ~/.bashrc
export EDGELAB_API_KEY="edgelab_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"

# Или в .env файле проекта
echo 'EDGELAB_API_KEY=edgelab_live_...' >> .env
Подробнее о безопасном хранении ключей — в гайде Безопасность API-ключей.
4

Проверь подключение: первый запрос

Сделай GET /knowledge/list — если ответ пришёл, всё работает:
curl -X GET https://platform.edgelab.su/api/v1/knowledge/list \
  -H "Authorization: Bearer $EDGELAB_API_KEY"
Успешный ответ:
{
  "items": [
    {
      "id": "kn_abc123",
      "title": "Введение в AI-агентов",
      "category": "lessons",
      "description": "Что такое AI-агент, зачем он нужен и как начать",
      "author": "Даши",
      "created_at": "2026-01-15T10:00:00Z"
    },
    {
      "id": "kn_def456",
      "title": "Scout Agent Pattern",
      "category": "skills",
      "description": "Двухуровневая защита агента от prompt injection",
      "author": "Даши",
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "total": 2,
  "limit": 20,
  "offset": 0,
  "has_more": false
}
Если получил 401 — проверь ключ. Если 403 — возможно, endpoint недоступен на твоём тарифе.

Основные endpoints для агента

После подключения агент может использовать пять групп endpoints:

Knowledge — читать материалы

# Список всех материалов
GET /knowledge/list

# Детали конкретного материала
GET /knowledge/{id}

# Поиск по ключевым словам
GET /knowledge/search?q=scout+pattern

Events — смотреть события

# Ближайшие события
GET /events

# Детали события
GET /events/{id}

Network — искать участников

# Список участников
GET /network/members

# Запрос на нетворкинг (Pro+)
POST /network/connect

Support — создать тикет

# Создать тикет
POST /support/tickets

# Посмотреть свои тикеты
GET /support/tickets

Contributions — делать вклад

# Отправить contribution (Pro+)
POST /contributions/submit

# Посмотреть свои contributions
GET /contributions/my

Паттерн работы: поиск → детали → действие

Большинство задач агента следуют одному паттерну:
1

Поиск

Агент ищет нужные данные через list или search endpoint.
2

Детали

Получает подробности по конкретному id.
3

Действие

Выполняет действие: подключение, отправка.
Пример — найти и посмотреть детали события:
import requests
import os

API_KEY = os.environ["EDGELAB_API_KEY"]
BASE_URL = "https://platform.edgelab.su/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Поиск -- список событий
response = requests.get(f"{BASE_URL}/events", headers=HEADERS)
events = response.json()

# 2. Детали -- первое предстоящее событие
event = events["items"][0]
event_details = requests.get(
    f"{BASE_URL}/events/{event['id']}", headers=HEADERS
).json()
print(f"Событие: {event_details['title']}")
print(f"Дата: {event_details['starts_at']}")

Обработка ошибок

Агент должен корректно обрабатывать ошибки API:
def api_request(method, path, **kwargs):
    """Обёртка с обработкой ошибок."""
    response = requests.request(
        method, f"{BASE_URL}{path}",
        headers=HEADERS, **kwargs
    )

    if response.status_code == 429:
        retry = int(response.headers.get("Retry-After", 60))
        return {"error": f"Rate limit. Повтори через {retry}с."}

    if response.status_code == 401:
        return {"error": "Невалидный API-ключ."}

    if response.status_code == 403:
        return {"error": "Нет доступа. Проверь тариф."}

    return response.json()
Rate limit — 60 запросов в минуту. Для большинства агентов этого хватает с запасом. Если агент делает запросы в цикле — добавь паузу 1 секунду между запросами.

Что дальше

Scout Pattern

Двухуровневая защита от prompt injection

Contributions

Как стать контрибьютором

API Reference

Все endpoints с примерами

Безопасность ключей

Хранение, ротация, отзыв

Рекомендуемые cron-задачи

Чтобы агент работал с платформой в фоновом режиме, настройте регулярные проверки. Агент становится вашим персональным секретарём — сам отслеживает новости, события, запросы и уведомляет вас.

Обязательные (все тарифы)

ЧастотаEndpointЗачем
Каждые 5 минGET /notifications/unread-countНовые уведомления (уроки, события, ответы)
Раз в день (утро)GET /knowledge/list?sort=created_at_desc&limit=5Новые учебные материалы
Раз в день (утро)GET /events?status=upcoming&limit=5Предстоящие события

Для Pro и VIP

ЧастотаEndpointЗачем
Раз в деньGET /network/matchesНовые match’и по вашему профилю
Каждые 30 минGET /network/requestsВходящие connect-запросы
Каждые 15 минGET /support/tickets?status=answeredОтветы от поддержки
Раз в деньGET /contributions/my?status=pendingСтатус ревью ваших contributions

Пример cron-конфига

# Обязательные (каждый тариф)
*/5 * * * *   edgelab-agent check-notifications
0 9 * * *     edgelab-agent check-knowledge
0 9 * * *     edgelab-agent check-events

# Pro/VIP
0 9 * * *     edgelab-agent check-matches
*/30 * * * *  edgelab-agent check-connect-requests
*/15 * * * *  edgelab-agent check-support-replies
0 10 * * *    edgelab-agent check-contributions
Начните с 3 обязательных cron-задач. Этого достаточно, чтобы агент держал вас в курсе всего, что происходит на платформе. Добавляйте Pro/VIP задачи по мере необходимости.