Холбоос өгөгдлийн бүтэц (Connection Data Structure)

Блокуудыг хооронд нь холбох үед, эх (source) блокийн гаралтын өгөгдлийн бүтэц нь зорилтот (destination) блок дээр ямар утгууд ашиглах боломжтойг тодорхойлдог тул өөр өөр блокийн гаралтын өгөгдлийн бүтцийг ойлгох нь маш чухал. Блокийн төрөл бүр нь өөрийн гэсэн тодорхой гаралтын бүтэцтэй бөгөөд үүнийг дараагийн (downstream) блокууд дээр reference хэлбэрээр ашиглаж болно.

Эдгээр өгөгдлийн бүтцийг ойлгох нь connection tag-уудыг үр дүнтэй ашиглах, мөн workflow дотор зөв өгөгдөлд хандахад зайлшгүй шаардлагатай.

Блокийн гаралтын өгөгдлийн бүтэц

Блокийн төрөл бүр өөр өөр гаралтын бүтэц үүсгэдэг. Доор блок бүрээс ямар бүтэц хүлээж болохыг харуулав:

{
  "content": "The generated text response",
  "model": "gpt-4o",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "toolCalls": [...],
  "cost": [...],
  "usage": [...]
}

Agent блокийн гаралтын талбарууд

content: Агентын үүсгэсэн үндсэн текст хариу
model: Ашигласан AI загвар (жишээ нь: "gpt-4o", "claude-3-opus")
tokens: Token ашиглалтын статистик
- prompt: Prompt-д ашиглагдсан token-уудын тоо
- completion: Completion-д ашиглагдсан token-уудын тоо
- total: Нийт ашиглагдсан token-ууд
toolCalls: Агентын дуудсан tool-уудын жагсаалт (хэрэв байгаа бол)
cost: Tool дуудлага бүрийн зардлын мэдээлэл (хэрэв байгаа бол)
usage: Нийт хариунд хамаарах token ашиглалтын мэдээлэл

{
  "data": "Response data",
  "status": 200,
  "headers": {
    "content-type": "application/json",
    "cache-control": "no-cache"
  }
}

API блокийн гаралтын талбарууд

data: API-аас буцаж ирсэн хариу өгөгдөл (ямар ч төрөл байж болно)
status: Хариуны HTTP статус код
headers: API-аас буцаж ирсэн HTTP header-ууд

{
  "result": "Function return value",
  "stdout": "Console output",
}

Function блокийн гаралтын талбарууд

result: Function-оос буцаасан утга (ямар ч бүтэцтэй байж болно)
stdout: Function ажиллах явцад консолд гарсан гаралт

{
  "content": "Evaluation summary",
  "model": "gpt-5",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "metric1": 8.5,
  "metric2": 7.2,
  "metric3": 9.0
}

Evaluator блокийн гаралтын талбарууд

content: Үнэлгээний товч дүгнэлт
model: Үнэлгээнд ашигласан AI загвар
tokens: Token ашиглалтын статистик
[metricName]: Evaluator дээр тодорхойлсон метрик бүрийн оноо (динамик талбарууд)

{
  "content": "Original content passed through",
  "conditionResult": true,
  "selectedPath": {
    "blockId": "2acd9007-27e8-4510-a487-73d3b825e7c1",
    "blockType": "agent",
    "blockTitle": "Follow-up Agent"
  },
  "selectedConditionId": "condition-1"
}

Condition блокийн гаралтын талбарууд

content: Дамжин өнгөрсөн анхны контент
conditionResult: Нөхцөлийн шалгалтын boolean үр дүн
selectedPath: Сонгогдсон замын мэдээлэл
- blockId: Дараагийн блокийн ID
- blockType: Дараагийн блокийн төрөл
- blockTitle: Дараагийн блокийн нэр
selectedConditionId: Сонгогдсон нөхцөлийн ID

{
  "content": "Routing decision",
  "model": "gpt-4o",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "selectedPath": {
    "blockId": "2acd9007-27e8-4510-a487-73d3b825e7c1",
    "blockType": "agent",
    "blockTitle": "Customer Service Agent"
  }
}

Router блокийн гаралтын талбарууд

content: Routing шийдвэрийн тайлбар текст
model: Routing-д ашигласан AI загвар
tokens: Token ашиглалтын статистик
selectedPath: Сонгогдсон замын мэдээлэл
- blockId: Сонгогдсон зорилтот блокийн ID
- blockType: Сонгогдсон блокийн төрөл
- blockTitle: Сонгогдсон блокийн нэр

Захиалгат гаралтын бүтэц

Зарим блокууд нь өөрийн тохиргооноос хамааран захиалгат гаралтын бүтэц үүсгэж болно:

Response Format ашигласан Agent блокууд: Agent блок дээр response format тохируулсан тохиолдолд гаралт нь стандарт бүтэц биш, харин тодорхойлсон schema-д нийцнэ.
Function блокууд: result талбар нь таны function кодоос буцаасан ямар ч өгөгдлийн бүтцийг агуулж болно.
API блокууд: data талбар нь API-аас буцаж ирсэн ямар ч valid JSON бүтцийг агуулна.

Development явцад блок бүрийн бодит гаралтын бүтцийг шалгаж, connection дээрээ зөв талбаруудыг reference хийж байгаа эсэхээ үргэлж баталгаажуулж байгаарай.

Давхарласан өгөгдлийн бүтэц (Nested Data Structures)

Олон блокийн гаралт нь давхарласан өгөгдлийн бүтэцтэй байдаг. Үүнд connection tag дээр dot notation ашиглан хандаж болно:

<blockName.path.to.nested.data>

Жишээ нь:

<agent1.tokens.total> – Agent блокийн нийт token тоонд хандах
<api1.data.results[0].id> – API хариуны эхний үр дүнгийн ID-д хандах
<function1.result.calculations.total> – Function блокийн result доторх nested талбарт хандах

Холбоос өгөгдлийн бүтэц (Connection Data Structure)

On this page