Агенты

Передайте результат endpoint'у вашего собственного агента с инструкциями и инструментами маршрута — дождитесь его ответа в ответе API или передайте работу в фоне с повторными попытками.

Назначение агент вызывает endpoint, который работает у вас, — ваш агент поддержки, сервис на LangGraph или Agents SDK, внутренний ассистент — с состоянием, инструкциями маршрута и инструментами, которые агент может использовать на этом маршруте. Dcision решает, какой агент и с каким заданием; работу делает ваш агент.

modeЧто происходитВ ответе
sync (по умолчанию)Dcision вызывает агента, пока вызывающая сторона ждёт, и извлекает его ответ."status": "completed" с reply или "status": "failed" с error.
asyncПередача дальше: запрос ставится в очередь и доставляется в фоне, с повторными попытками."status": "queued" с delivery_id.

Настройка

{
  "key": "shipping_agent",
  "type": "agent",
  "when": { "conditions": [{ "field": "department", "on": "output", "operator": "eq", "value": "shipping" }] },
  "params": { "awb": { "from": "state.awb", "required": true } },
  "agent": {
    "url": "https://agents.example.com/support",
    "headers": [{ "name": "Authorization", "value": "Bearer {{secrets.AGENT_TOKEN}}" }],
    "instructions": "Help with the shipment {{params.awb}}. Confirm the address before rescheduling.",
    "tools": ["track_package", "reschedule_delivery"],
    "mode": "sync",
    "replyPath": "data.answer",
    "timeoutMs": 20000
  }
}
ПолеТипПо умолчаниюОписание
urlstring—Ваш endpoint: https://… или {{secrets.NAME}}, содержащий весь URL. До 2 048 символов, с переменными.
headersarray[]До 20 пар { "name", "value" }; значения до 2 048 символов, с переменными и секретами.
instructionsstring—Промпт маршрута, отправляемый как instructions: до 32 000 символов — места хватит на целый регламент — с переменными, без секретов.
toolsarray[]До 50 названий инструментов, известных вашему агенту, — буквы, цифры и _ . : -, до 64 символов каждое.
modestringsyncsync или async.
replyPathstring—Только sync: где находится ответ в JSON-ответе агента, в виде пути через точку, например data.answer.
timeoutMsinteger20000От 1 000 до 25 000 — только sync.

Запрос, который получает ваш агент

POST /support HTTP/1.1
Host: agents.example.com
Content-Type: application/json
Authorization: Bearer agt_live_51Hq…
User-Agent: Dcision-Destinations/1.0 (+https://docs.dcision.io/destinations)
Dcision-Delivery: dlv_Hq2Lm9Xc4Rv1Tz8Wn3Bk
Dcision-Attempt: 1
Dcision-Event: decision.completed
Dcision-Signature: t=1759658400,v1=6f1c2b…
Idempotency-Key: dlv_Hq2Lm9Xc4Rv1Tz8Wn3Bk
Тело
{
  "input": { "message": "Where is my package? It was due yesterday.", "awb": "4471-2210" },
  "instructions": "Help with the shipment 4471-2210. Confirm the address before rescheduling.",
  "tools": ["track_package", "reschedule_delivery"],
  "params": { "awb": "4471-2210" },
  "decision": {
    "decision": "support-desk",
    "decision_id": "dec_7Wq2Lm9Xc4Rv1Tz8Wn3B",
    "version": 2,
    "execution_id": "exec_Vn4Kp8Wd2Lq6Tz1Xc9Bs",
    "result": { "department": "shipping", "urgency": "medium" },
    "confidence": { "department": 0.92, "urgency": 0.71 },
    "action": "continue",
    "action_reason": { "type": "default" },
    "destination": "shipping_agent",
    "delivery_id": "dlv_Hq2Lm9Xc4Rv1Tz8Wn3Bk",
    "livemode": true
  }
}
ПолеОписание
inputВсё состояние в том виде, в каком его отправила вызывающая сторона.
instructionsПромпт маршрута с подставленными переменными; null, если у назначения его нет.
toolsНазвания инструментов маршрута.
paramsПараметры назначения.
decisionЧто ответило решение — slug и ID, version (null в Playground), result, confidence, action, action_reason, — а также ключ назначения, delivery_id и livemode (false для тестовых ключей и Playground).

Запрос подписан так же, как вебхук: проверяйте Dcision-Signature по сырому телу с помощью verifySignature — тело является запросом агенту, а не событием вебхука. В режиме async дедуплицируйте по Idempotency-Key — ID доставки, который одинаков во всех попытках.

Какой ответ ожидает Dcision

В режиме sync ответьте 2xx в пределах timeoutMs. Dcision берёт ответ:

  1. из поля по пути replyPath, если вы его задали;
  2. иначе из первого существующего поля верхнего уровня среди: reply, output_text, output, text, message, content;
  3. или из всего тела, если ответ не JSON.

Строка используется как есть; другие значения возвращаются как текст JSON.

В ответе
{
  "key": "shipping_agent",
  "type": "agent",
  "status": "completed",
  "reply": "Your package is at the local depot. I can deliver it tomorrow between 9 and 12 — shall I book it?",
  "response": { "data": { "answer": "Your package is at the local depot. I can deliver it tomorrow between 9 and 12 — shall I book it?", "session": "s_9f2c" } }
}

response — это весь ответ агента, разобранный, если он в JSON, и null, если он длиннее 16 000 символов. reply равен null, если поле ответа не найдено, — задайте Поле ответа (replyPath) в назначении.

Вызов sync выполняется один раз: без повторов, редиректы не выполняются, а ответ читается до 64 КБ. Всё остальное становится записью с ошибкой, а решение всё равно отвечает:

{ "key": "shipping_agent", "type": "agent", "status": "failed", "error": "The agent answered 503. upstream overloaded" }

К сбоям относятся ответ не 2xx (с началом его тела), таймаут, сетевая ошибка, непубличный адрес и отсутствующий секрет.

Вызывающая сторона ждёт агентов sync параллельно с ответами LLM; за одно выполнение запускается не больше 3 таких назначений.

Передача дальше (async)

С "mode": "async" тот же подписанный запрос ставится в очередь и доставляется по расписанию повторов вебхуков — шесть попыток примерно за семь часов, по 10 секунд каждая. Важен только статус вашего ответа: ответьте 2xx, как только приняли задачу, и продолжайте работу на своей стороне.

Минимальный endpoint агента

import express from "express";
import { DcisionError, verifySignature } from "@dcision/sdk";

const app = express();

// The raw body: the signature covers the exact bytes Dcision sent.
app.post("/support", express.raw({ type: "application/json" }), async (req, res) => {
  try {
    await verifySignature(req.body, req.header("dcision-signature"), process.env.DCISION_WEBHOOK_SECRET!);
  } catch (error) {
    return res.sendStatus(error instanceof DcisionError ? 400 : 500);
  }
  const task = JSON.parse(req.body.toString("utf8"));
  const reply = await supportAgent.run({
    input: task.input,
    instructions: task.instructions,
    tools: task.tools,
    conversationId: task.decision.execution_id,
  });
  res.json({ reply });
});

Примеры используют SDK, которые собираются из исходников, пока не опубликованы.

Данные

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

На этой странице