Kontextus és változók

Az IntraCord egy egyszerű adatmodellel rendelkezik az információk híváson keresztüli átadására. Ennek megértése kulcsfontosságú a személyre szabott ügynökök kialakításához és a hívás utáni hasznos eredmények eléréséhez.

A három kontextusobjektum

initial_context ──► Agent ──► gathered_context
                       │
                 [template variables](/voice-agent/template-variables)
                 (used in prompts)

kezdeti_kontextus

Az ügyintéző rendelkezésére álló adatok a hívás megkezdése előtt – a kapcsolattartó neve, a fiók adatai, a találkozó információi, minden, amit az ügynöknek tudnia kell. Több helyről is beállítható:

• API trigger – adja át a kérés törzsében a POST /public/agent/{uuid} vagy POST /telephony/initiate-call hívásakor
• Campaign CSV – a phone_number-n túli oszlopok automatikusan initial_context mezőkké válnak minden egyes partner hívásánál
• Pre-call data fetch – gazdagítsa a kontextust a CRM-ből vagy az ERP-ből származó adatokkal HTTP-híváson keresztül a hívás kezdetekor, mielőtt az ügynök megszólal.
• Agent Settings — sablon környezeti változók beállítása az ügynökön teszteléshez; bekerülnek a workflow-szerkesztő teszthívásaiba, és figyelmen kívül hagyják őket az éles hívásoknál

Sablonváltozók

A initial_context értékei elérhetők az ügynök promptjában a {{double_brace}} szintaxis használatával.

You are calling {{customer_name}} about their {{plan}} plan,
which renews on {{renewal_date}}. Be friendly and confirm
whether they'd like to continue.

Amikor a hívás elindul, az IntraCord lecseréli az értékeket, mielőtt elküldi a promptot az LLM-nek – így az ügynök természetesen beszél, mintha már ismerné a kapcsolattartót.

Tartalék értékek

Ha egy változó hiányzik vagy üres, használjon cső (|) segítségével az alapértelmezett értéket:

Hello {{customer_name | there}}, we're calling about your {{plan | current}} plan.

Ha a customer_name nincs beállítva, az ügynök ahelyett, hogy üresen hagyna, azt mondja: "Helló". A szintaxis a következő:

{{variable_name | fallback_value}}

Ha a változó jelen van és nem üres, a rendszer figyelmen kívül hagyja a tartalékot, és a tényleges értéket használja.

Alapértelmezett változók

Beépített változók az aktuális időhöz és a hétköznapokhoz, bármely promptban elérhetők a initial_context beállítása nélkül.

Változó	Leírás	Példa kimenet
{{current_time}}	Jelenlegi idő UTC-ben (vagy kikövetkeztetett időzónában)	2026-04-02 14:30:45 UTC
{{current_time_<TIMEZONE>}}	Jelenlegi idő a megadott időzónában	2026-04-02 20:00:45 IST
{{current_weekday}}	A hétköznapok aktuális neve UTC-ben (vagy kikövetkeztetett időzónában)	Thursday
{{current_weekday_<TIMEZONE>}}	Az aktuális hétköznap neve a megadott időzónában	Thursday

Cserélje ki a <TIMEZONE>-t egy IANA-időzóna neve, például Asia/Kolkata, America/New_York vagy Europe/London-re.

Today is {{current_weekday}} and the current time is {{current_time_America/New_York}}.

i

Ha időzóna utótagot használ a vagy current_time vagy current_weekday értéknél, a másik utótag nélküli változó automatikusan ugyanazt az időzónát fogja használni UTC helyett. Ha például a prompt a {{current_time_Asia/Kolkata}} és a {{current_weekday}} Stringet is tartalmazza, akkor a hét napja is a Asia/Kolkata formátumban lesz feloldva.

Telefonos változók

Telefonhívások esetén (bejövő és kimenő) az IntraCord automatikusan hozzáadja a következő változókat a initial_context-hez:

Változó	Leírás	Példa
{{caller_number}}	A hívást kezdeményező telefonszám	+14155550100
{{called_number}}	A hívást fogadó telefonszám	+18005550199

A bejövő hívásoknál a caller_number az ügyfél száma, a called_number pedig az Ön IntraCord-száma. A kimenő hívásoknál ez fordítva működik – a caller_number az Ön IntraCord-száma, a called_number pedig az ügyfél száma.

You are speaking with the caller at {{caller_number}}.

összegyűjtött_kontextus

Adatok, amelyeket az ügyintéző a hívás közben kinyert – a initial_context ellenkező iránya. Segítségével a beszélgetést strukturált adatokká alakíthatja: mit akar az ügyfél, megerősített-e valamit, milyen értéket adott Önnek hangosan.

Hogyan népesül be

Kapcsolja be a kivonást egy Agent vagy End Call Node-on, és adjon meg egy vagy több változót a kivonatolandó. Mindegyik változó rendelkezik:

Mező	Leírás
name	A kulcs alatt megjelenik a gathered_context
type	string, number vagy boolean
prompt	Természetes nyelvű leírás, hogy mit kell keresni, pl. "Megerősítette az ügyfél a találkozót?"

Amikor a beszélgetés eléri ezt a Node-ot, az LLM beolvassa az eddigi átiratot, és kitölti az egyes változókat a prompt alapján. Ha egy érték nem határozható meg a beszélgetésből, a változó üresen marad, nem pedig kitalálni – hagyja eléggé a prompt értéket, hogy az LLM pontosan tudja, mi számít egyezésnek.

A kivonatolást több Node-hoz is hozzáadhatja. Az egyes Node-ok kibontott változói a hívás előrehaladtával ugyanabba a gathered_context objektumba egyesülnek, a name kulcsszóval – használjon újra egy name-t egy későbbi Node-on, ha felül szeretne írni egy korábbi értéket.

Hogyan lehet hivatkozni rá

A gathered_context nem érhető el az ügynökpromptokban – a prompt csak a initial_context mezőkre hivatkozhat, mivel a kicsomagolás általában az azt használó beszélgetés után történik. Ha a kinyert adatokon szeretne cselekedni, küldje ki azokat egy Node-on keresztül:

Hol	Szintaxis	Megjegyzések
Webhook Node payload	{{gathered_context.field_name}}	Előtag, mivel a payload template hivatkozhat a initial_context
Rekord futtatása (API / Dashboard)	gathered_context objektum	Visszaküldve a futás befejezése után, recording_url és transcript_url mellett

{
  "customer": "{{initial_context.customer_name}}",
  "resolution": "{{gathered_context.resolution}}",
  "callback_requested": "{{gathered_context.wants_callback}}"
}

Tekintse meg a Webhook Payloads részt a hasznosadat-sablonban a gathered_context mellett elérhető változók teljes listájáért.

Adatfolyam példa

Ahol elérhetők a változók

Helyszín	Elérhető változók
Agent Node requestek	initial_context mezők a {{variable_name}}-n keresztül
Edge-feltételek	Az élő beszélgetéshez képest értékelve – nincs szükség explicit változó szintaxisra
Webhook payload template-ek	Minden környezeti objektum a {{initial_context.field}}, {{gathered_context.field}} stb. segítségével
Kampány CSV oszlopai	A phone_number-n túli CSV-oszlopok automatikusan initial_context mezőkké válnak