trustgraph/docs/tech-specs/flow-class-definition.sw.md

layout	title	parent
default	Maelezo ya Ufafanuzi wa Mfumo wa Mtiririko	Swahili (Beta)

Maelezo ya Ufafanuzi wa Mfumo wa Mtiririko

Beta Translation: This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.

Muhtasari

<<<<<<< HEAD Mfumo wa mtiririko unafafanua kiolezo kamili cha mtiririko wa data katika mfumo wa TrustGraph. Unapoongezwa, huunda mtandao unaounganishwa wa vichakata ambavyo hushughulikia uingizaji wa data, uchakataji, uhifadhi, na kuulizia kama mfumo mmoja.

Mfumo wa mtiririko unafafanua mfumo kamili wa mtiririko wa data katika mfumo wa TrustGraph. Unapoongezwa, huunda mtandao unaounganishwa wa vichakata ambavyo hushughulikia uingizaji wa data, uchakataji, uhifadhi, na kuulizia kama mfumo mmoja.

82edf2d (New md files from RunPod)

Muundo

Ufafanuzi wa mfumo wa mtiririko una sehemu tano kuu:

1. Sehemu ya Darasa

<<<<<<< HEAD Inafafanua vichakata vya huduma ambavyo huanzishwa mara moja kwa kila mfumo wa mtiririko. Vichakata hivi hushughulikia ombi kutoka kwa visasisho vyote vya mfumo wa mtiririko vya darasa hili.

Inafafanua vichakata vya huduma ambavyo huanzishwa mara moja kwa kila mfumo wa mtiririko. Vichakata hivi hushughulikia ombi kutoka kwa visasisho vyote vya mfumo wa mtiririko wa darasa hili.

82edf2d (New md files from RunPod)

"class": {
  "service-name:{class}": {
    "request": "queue-pattern:{class}",
    "response": "queue-pattern:{class}",
    "settings": {
      "setting-name": "fixed-value",
      "parameterized-setting": "{parameter-name}"
    }
  }
}

Sifa: Zinashirikiwa katika visasisho vyote vya aina moja. Hutoa huduma za kawaida au zisizo na hali (LLMs, modeli za uingizaji). <<<<<<< HEAD Tumia jina la kigezo cha {class} kwa ajili ya kujina kwa folyo.

Tumia jina la kigezo {class} kwa ajili ya kujina kwa folyo.

82edf2d (New md files from RunPod) Mipangilio inaweza kuwa maadili thabiti au kupangwa kwa kutumia sintaksia ya {parameter-name}. Mifano: embeddings:{class}, text-completion:{class}, graph-rag:{class}

2. Sehemu ya Folyo

Inafafanua vichakataji maalum ya folyo ambavyo huanzishwa kwa kila visa maalum la folyo. Kila folyo hupata seti yake mwenyewe ya vichakataji hivi.

"flow": {
  "processor-name:{id}": {
    "input": "queue-pattern:{id}",
    "output": "queue-pattern:{id}",
    "settings": {
      "setting-name": "fixed-value",
      "parameterized-setting": "{parameter-name}"
    }
  }
}

Sifa: Mfano pekee kwa kila mtiririko. Hushughulikia data na hali maalum ya mtiririko. Tumia kigezo cha {id} kwa ajili ya kujina kwa folyo. Mipangilio inaweza kuwa maadili thabiti au kupangishwa kwa kutumia sintaksia ya {parameter-name}. Mifano: chunker:{id}, pdf-decoder:{id}, kg-extract-relationships:{id}.

<<<<<<< HEAD

3. Sehemu ya Vifaa

Inaelezea pointi za kuingilia na mikataba ya mwingiliano kwa mtiririko. Haya huunda safu ya API kwa mifumo ya nje na mawasiliano ya vipengele vya ndani.

Vifaa vinaweza kuwa na aina mbili:

Sura ya 3. Sehemu ya Vifaa vya Kuunganisha

Inaelezea pointi za kuingilia na mikataba ya kuingiliana kwa mtiririko. Hizi huunda safu ya API kwa mifumo ya nje na mawasiliano ya vipengele vya ndani.

Vifaa vya kuunganisha vinaweza kuwa na aina mbili:

82edf2d (New md files from RunPod)

Mfumo wa "Tuma na Usahau" (folyo moja):

"interfaces": {
  "document-load": "persistent://tg/flow/document-load:{id}",
  "triples-store": "persistent://tg/flow/triples-store:{id}"
}

<<<<<<< HEAD Muundo wa Ombi/Jibu (kitu chenye sehemu za ombi/jibu):

Muundo wa Ombi/Jibu (objekti yenye sehemu za ombi/jibu):

82edf2d (New md files from RunPod)

"interfaces": {
  "embeddings": {
    "request": "non-persistent://tg/request/embeddings:{class}",
    "response": "non-persistent://tg/response/embeddings:{class}"
  }
}

<<<<<<< HEAD Aina za Mfumo: Vituo vya Kuingia: Maeneo ambapo mifumo ya nje huingiza data (document-load, agent) Mifumo ya Huduma: Mfumo wa ombi/jibu kwa huduma (embeddings, text-completion) Mifumo ya Data: Vituo vya muunganisho wa mtiririko wa data (triples-store, entity-contexts-load)

4. Sehemu ya Vigezo

Huunganisha majina ya vigezo maalum ya mtiririko na ufafanuzi wa vigezo unaohifadhiwa katika eneo moja:

Aina za Vifaa vya Kuunganisha: Vifaa vya Kuanzia: Maeneo ambapo mifumo ya nje huingiza data (document-load, agent) Vifaa vya Huduma: Mfumo wa ombi/jibu kwa huduma (embeddings, text-completion) Vifaa vya Data: Vifaa vya kuunganisha mtiririko wa data (triples-store, entity-contexts-load)

4. Sehemu ya Vigezo

Huunganisha majina ya vigezo maalum ya mtiririko na ufafanuzi wa vigezo unaohifadhiwa katika eneo la kati:

82edf2d (New md files from RunPod)

"parameters": {
  "model": "llm-model",
  "temp": "temperature",
  "chunk": "chunk-size"
}

Sifa: <<<<<<< HEAD Nenosiri ni majina ya vigezo yanayotumika katika mipangilio ya kichakata (k.m., {model})

Funguo ni majina ya vigezo yanayotumika katika mipangilio ya kichakata (k.m., {model})

82edf2d (New md files from RunPod) Maelezo yanaashiria ufafanuzi wa vigezo uliohifadhiwa katika schema/config Inaruhusu matumizi ya mara kwa mara ya ufafanuzi wa kawaida wa vigezo katika michakato. Hupunguza marudio ya schemas za vigezo.

5. Meta Data

<<<<<<< HEAD Taarifa za ziada kuhusu mpango wa mtiririko:

Habari ya ziada kuhusu mpango wa mtiririko:

82edf2d (New md files from RunPod)

"description": "Human-readable description",
"tags": ["capability-1", "capability-2"]

Vigezo vya Kiolele

Vigezo vya Mfumo

{id}

<<<<<<< HEAD Huibwa na kitambulisho kipekee cha kila mfumo. Huunda rasilimali zilizotengwa kwa kila mfumo. Mifano: flow-123, customer-A-flow

{class}

Huibwa na jina la mpango wa mfumo. Huunda rasilimali zilizoshirikiwa katika mifumo ya aina moja. Mifano: standard-rag, enterprise-rag

Huibadilishwa na kitambulisho kipekee cha kila mtiririko. Huunda rasilimali zilizojitenga kwa kila mtiririko. Mfano: flow-123, customer-A-flow

{class}

Huibadilishwa na jina la mpango wa mtiririko. Huunda rasilimali zilizoshirikiwa katika mitiririko ya aina moja. Mfano: standard-rag, enterprise-rag

82edf2d (New md files from RunPod)

Vigezo vya Parameta

{parameter-name}

<<<<<<< HEAD Parameta maalum zilizobainishwa wakati wa kuanzisha mfumo. Majina ya parameta yanalingana na funguo katika sehemu ya parameters ya mfumo. Hutumiwa katika mipangilio ya kichakuzi ili kuboresha tabia. Mifano: {model}, {temp}, {chunk} Huibwa na maadili yaliyotolewa wakati wa kuanzisha mfumo. Yanathibitishwa kulingana na ufafanuzi wa parameta uliohifadhiwa katika mfumo.

Mpangilio wa Kichakuzi

Mpangilio hutoa maadili ya usanidi kwa vichakuzi wakati wa uundaji. Inaweza kuwa:

Mpangilio Thabiti

======= Parameta maalum zilizobainishwa wakati wa kuanzisha mtiririko. Majina ya parametri yanalingana na funguo katika sehemu ya parameters ya mtiririko. Hutumiwa katika mipangilio ya kichakataji ili kuboresha tabia. Mifano: {model}, {temp}, {chunk} Huibadilishwa na maadili yaliyotolewa wakati wa kuanzisha mtiririko. Yanathibitishwa kulingana na ufafanuzi wa parametri uliohifadhiwa katika mfumo.

Mipangilio ya Kichakataji

Mipangilio hutoa maadili ya usanidi kwa vichakataji wakati wa uundaji. Inaweza kuwa:

Mipangilio Thabiti

82edf2d (New md files from RunPod) Maadili ya moja kwa moja ambayo hayubadiliki:

"settings": {
  "model": "gemma3:12b",
  "temperature": 0.7,
  "max_retries": 3
}

<<<<<<< HEAD

Mipangilio Iliyobadilishwa

=======

Parameta za Mpangilio

82edf2d (New md files from RunPod) Maelezo ambayo hutumia vigezo vilivyotolewa wakati wa kuanzisha mtiririko:

"settings": {
  "model": "{model}",
  "temperature": "{temp}",
  "endpoint": "https://{region}.api.example.com"
}

Majina ya vigezo katika mipangilio yanalingana na funguo katika sehemu ya parameters ya mtiririko.

Mifano ya Mipangilio

Mchakato wa LLM na Vigezo:

// In parameters section:
"parameters": {
  "model": "llm-model",
  "temp": "temperature",
  "tokens": "max-tokens",
  "key": "openai-api-key"
}

// In processor definition:
"text-completion:{class}": {
  "request": "non-persistent://tg/request/text-completion:{class}",
  "response": "non-persistent://tg/response/text-completion:{class}",
  "settings": {
    "model": "{model}",
    "temperature": "{temp}",
    "max_tokens": "{tokens}",
    "api_key": "{key}"
  }
}

<<<<<<< HEAD Kifurushi cha Mpangilio wa Kurekebisha na Unaoweza Kubadilishwa:

Sehemu za Kujumuisha Zenye Mipangilio Thabiti na Inayoweza Kubadilishwa:

82edf2d (New md files from RunPod)

// In parameters section:
"parameters": {
  "chunk": "chunk-size"
}

// In processor definition:
"chunker:{id}": {
  "input": "persistent://tg/flow/chunk:{id}",
  "output": "persistent://tg/flow/chunk-load:{id}",
  "settings": {
    "chunk_size": "{chunk}",
    "chunk_overlap": 100,
    "encoding": "utf-8"
  }
}

Mifumo ya Kinyororo (Pulsar)

<<<<<<< HEAD Mfumo wa mtiririko hutumia Apache Pulsar kwa ujumbe. Majina ya nyororo yanafuata muundo wa Pulsar:

Mfumo wa mtiririko hutumia Apache Pulsar kwa ajili ya ujumbe. Majina ya nyororo yanafuata muundo wa Pulsar:

82edf2d (New md files from RunPod)

<persistence>://<tenant>/<namespace>/<topic>

Vipengele:

<<<<<<< HEAD uthibitisho: persistent au non-persistent (Njia ya uthibitisho ya Pulsar) mwendeshaji: tg kwa maelezo ya muundo wa mtiririko yanayotolewa na TrustGraph nafasi: Inaonyesha muundo wa ujumbe

uhifadhi: persistent au non-persistent (Njia ya uhifadhi ya Pulsar) mwendeshaji: tg kwa maelekezo ya muundo wa mtiririko yanayotolewa na TrustGraph nafasi: Inaonyesha mtindo wa ujumbe

82edf2d (New md files from RunPod) flow: Huduma za "tumia na usahau" request: Sehemu ya ombi ya huduma za ombi/jibu response: Sehemu ya jibu ya huduma za ombi/jibu mada: Jina maalum la folyo/mada na vigezo vya kiolezo

Folyozilizohifadhiwa

<<<<<<< HEAD Muundo: persistent://tg/flow/<topic>:{id} Inatumika kwa huduma za "tumia na usahau" na mtiririko wa data endelevu Data inabaki katika hifadhi ya Pulsar wakati wa kuanzishwa upya Mfano: persistent://tg/flow/chunk-load:{id}

Folyozilizohifadhiwa

Muundo: non-persistent://tg/request/<topic>:{class} au non-persistent://tg/response/<topic>:{class} Inatumika kwa muundo wa ujumbe wa ombi/jibu Inapotea, haihifadhiwa kwenye diski na Pulsar Latensi ndogo, inafaa kwa mawasiliano ya aina ya RPC

Mtindo: persistent://tg/flow/<topic>:{id} Inatumika kwa huduma za "tumia na usahau" na mtiririko wa data endelevu Data inahifadhiwa katika hifadhi ya Pulsar katika kuanzishwa upya Mfano: persistent://tg/flow/chunk-load:{id}

Folyozilizohifadhiwa

Mtindo: non-persistent://tg/request/<topic>:{class} au non-persistent://tg/response/<topic>:{class} Inatumika kwa mitindo ya ujumbe ya ombi/jibu Inapotea, haihifadhiwi kwenye diski na Pulsar Latensi ya chini, inayofaa kwa mawasiliano ya aina ya RPC

82edf2d (New md files from RunPod) Mfano: non-persistent://tg/request/embeddings:{class}

Usanifu wa Mtiririko wa Data

<<<<<<< HEAD Muundo wa mtiririko huunda mtiririko wa data unaounganishwa ambapo:

1. Mchakato wa Kusindika Nyaraka: Mtiririko kutoka kwa kupokea hadi kubadilisha hadi kuhifadhi ======= Muundo wa mtiririko huunda mtiririko wa data uliounganishwa ambapo:

2. Mchakato wa Kusindika Nyaraka: Mtiririko kutoka kwa kupokea kupitia mabadiliko hadi kuhifadhi

82edf2d (New md files from RunPod)

2. Huduma za Uchunguzi: Wasindikaji waliojumuishwa ambao huchunguza hifadhi na huduma sawa za data
3. Huduma Zilizoshirikiwa: Wasindikaji wa kati ambao mtiririko wote unaweza kutumia
4. Waandikaji wa Hifadhi: Kuhifadhi data iliyosindikwa kwenye hifadhi husika

<<<<<<< HEAD Wasindikaji wote (wote {id} na {class}) hufanya kazi pamoja kama grafu moja ya mtiririko wa data, sio mifumo tofauti.

Wasindikaji wote (wote {id} na {class}) hufanya kazi pamoja kama grafu ya mtiririko wa data iliyounganishwa, sio mifumo tofauti.

82edf2d (New md files from RunPod)

Uanzishaji wa Mfano wa Mtiririko

Imepewa: Kitambulisho cha Mfano wa Mtiririko: customer-A-flow Muundo wa Mtiririko: standard-rag Ramani za vigezo vya mtiririko: "model": "llm-model" "temp": "temperature" "chunk": "chunk-size" Vigezo vilivyotolewa na mtumiaji: model: gpt-4 temp: 0.5 chunk: 512

Upanuzi wa kiolezo: persistent://tg/flow/chunk-load:{id} → persistent://tg/flow/chunk-load:customer-A-flow non-persistent://tg/request/embeddings:{class} → non-persistent://tg/request/embeddings:standard-rag "model": "{model}" → "model": "gpt-4" "temperature": "{temp}" → "temperature": "0.5" "chunk_size": "{chunk}" → "chunk_size": "512"

Hii huunda: Mchakato wa kusindika nyaraka uliotengwa kwa customer-A-flow <<<<<<< HEAD Huduma ya pamoja ya uingizaji kwa mtiririko wote wa standard-rag Mtiririko kamili kutoka kwa kupokea nyaraka hadi uchunguzi Wasindikaji walioelekezwa na maadili ya vigezo vilivyotolewa

Huduma ya pamoja ya uingishaji kwa mtiririko wote wa standard-rag Mtiririko kamili kutoka kwa kupokea nyaraka hadi uchunguzi Wasindikaji uliopangwa na maadili ya vigezo vilivyotolewa

82edf2d (New md files from RunPod)

Faida

1. Ufanisi wa Rasilimali: Huduma ghali hushirikiwa katika mitiririko
2. Kutengwa kwa Mtiririko: Kila mtiririko una mchakato wake wa kusindika data
3. Uwezo wa Kupanuka: Inaweza kuanzisha mitiririko mingi kutoka kwa kiolezo kimoja
4. Uunganishaji: Tofauti wazi kati ya vipengele vilivyoshirikiwa na vilivyohusiana na mtiririko
5. Usanifu Uliounganishwa: Uchunguzi na usindikaji ni sehemu ya mtiririko mmoja wa data