Агенты
Передайте результат 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
}
}| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
url | string | — | Ваш endpoint: https://… или {{secrets.NAME}}, содержащий весь URL. До 2 048 символов, с переменными. |
headers | array | [] | До 20 пар { "name", "value" }; значения до 2 048 символов, с переменными и секретами. |
instructions | string | — | Промпт маршрута, отправляемый как instructions: до 32 000 символов — места хватит на целый регламент — с переменными, без секретов. |
tools | array | [] | До 50 названий инструментов, известных вашему агенту, — буквы, цифры и _ . : -, до 64 символов каждое. |
mode | string | sync | sync или async. |
replyPath | string | — | Только sync: где находится ответ в JSON-ответе агента, в виде пути через точку, например data.answer. |
timeoutMs | integer | 20000 | От 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 берёт ответ:
- из поля по пути
replyPath, если вы его задали; - иначе из первого существующего поля верхнего уровня среди:
reply,output_text,output,text,message,content; - или из всего тела, если ответ не 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 предпросмотр показывает точный запрос — с замаскированными секретами — без вызова вашего агента.
Ответы LLM
Пусть за маршрут отвечает модель — Dcision вызывает OpenRouter или Vercel AI Gateway с собственным ключом вашего рабочего пространства, промптом маршрута как system-сообщением и состоянием как входом.
Workflow
Запускайте n8n, Make, Zapier, Pipedream или любой URL workflow с переменными маршрута в виде плоских полей JSON и решением в поле dcision — с подписью и повторами в фоне.