Перейти к содержанию

Быстрый старт

Quickstart

За несколько минут проверьте Agent Card, отправьте сообщение агенту и перейдите к полной API-документации.

Base URLhttps://linnex.io/flows/api/v1/{flow_id}
AuthAuthorization: Bearer {token}
ProtocolJSON-RPC 2.0

1. Подготовьте параметры

Для примеров ниже нужны идентификатор flow и токен доступа.

export PLATFORM_TOKEN="your_token"
export PLATFORM_FLOW_ID="my-agent"
export PLATFORM_BASE_URL="https://linnex.io/flows/api/v1/${PLATFORM_FLOW_ID}"

Tip

Для серверных интеграций используйте API token в заголовке Authorization: Bearer .... Для встроенных виджетов доступен короткоживущий embed session token.

Legacy-домен

На humanitec.ru те же пути API и контракт JSON-RPC. Подставьте https://humanitec.ru/flows/api/v1/{flow_id} вместо linnex.io, если интеграция привязана к legacy apex.

2. Получите Agent Card

Agent Card описывает flow, поддерживаемые capabilities, доступные branches и публичные variables.

curl -H "Authorization: Bearer ${PLATFORM_TOKEN}" \
  "${PLATFORM_BASE_URL}"

GET /flows/api/v1/{flow_id} HTTP/1.1
Host: linnex.io
Authorization: Bearer {token}

3. Отправьте первое сообщение

Все интерактивные вызовы идут через POST на URL агента с JSON-RPC телом.

curl -X POST "${PLATFORM_BASE_URL}" \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}" \
  -H "A2A-Version: 1.0" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "SendMessage",
    "params": {
      "message": {
        "messageId": "msg-1",
        "role": "ROLE_USER",
        "parts": [
          {"text": "Помоги подготовить краткий статус по проекту"}
        ]
      }
    }
  }'

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "msg-1",
      "role": "ROLE_USER",
      "parts": [
        { "text": "Помоги подготовить краткий статус по проекту" }
      ]
    }
  }
}

4. Включите streaming

Для потоковых ответов замените метод на SendStreamingMessage. Ответ приходит через Server-Sent Events.

curl -N -X POST "${PLATFORM_BASE_URL}" \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}" \
  -H "A2A-Version: 1.0" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "stream-1",
    "method": "SendStreamingMessage",
    "params": {
      "message": {
        "messageId": "msg-stream-1",
        "role": "ROLE_USER",
        "parts": [
          {"text": "Расскажи, какие следующие шаги нужны для запуска агента"}
        ]
      }
    }
  }'

Дальше

API

Flows Public API

Полная страница A2A методов, branches, variables, files и задач.

 UI

Инструкции интерфейса

Проверьте, как ключевые пользовательские пути выглядят в продукте.