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

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

Quickstart

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

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

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

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

export HUMANITEC_TOKEN="your_token"
export HUMANITEC_FLOW_ID="my-agent"
export HUMANITEC_BASE_URL="https://humanitec.ru/flows/api/v1/${HUMANITEC_FLOW_ID}"

Tip

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

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

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

curl -H "Authorization: Bearer ${HUMANITEC_TOKEN}" \
  "${HUMANITEC_BASE_URL}"

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

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

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

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

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

4. Включите streaming

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

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

Дальше

API

Flows Public API

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

 UI

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

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