Áttekintés

HTTP method	Endpoint	Gyorshivatkozás
POST	/public/agent/{uuid}	Kimenő Agent Run indítása API Trigger Node-dal
POST	/public/agent/workflow/{workflow_uuid}	Kimenő Agent Run indítása Agent UUID-val
GET	/workflow/{workflow_id}/runs/{run_id}	Agent Run részleteinek lekérése
GET	/public/download/workflow/{token}/{artifact_type}	Felvételek és átiratok letöltése
POST	/telephony/inbound/{workflow_id}	Bejövő Run webhook

A megfelelő nyilvános Run route kiválasztása

Az IntraCord két nyilvános, kimenő Agent Run route-családot biztosít. Ezek nem cserélhetők fel, még akkor sem, ha mindkét path parameter UUID-nek tűnik.

Akkor használja, ha	Production route	Test route	Átadandó azonosító
API Trigger Node-ot adott a workflow-hoz, és ezt a triggert szeretné végrehajtani	/public/agent/{uuid}	/public/agent/test/{uuid}	Az API Trigger Node trigger UUID-ja (trigger_path)
A workflow-t stabil Agent UUID alapján, Trigger Node nélkül szeretné végrehajtani	/public/agent/workflow/{workflow_uuid}	/public/agent/test/workflow/{workflow_uuid}	A workflow UUID-ja az Agent Agent UUID mezőjéből

i

Ne adjon át workflow UUID-t a /public/agent/{uuid} route-nak, és trigger UUID-t se a /public/agent/workflow/{workflow_uuid} route-nak. Az IntraCord ezeket eltérő azonosítótípusként kezeli; felcserélésük esetén a request sikertelen lesz.

Miután az IntraCord feloldotta a cél Agentet, mindkét route-család azonosan működik:

• Ugyanazt a request body-t fogadják el
• Ugyanazt a response struktúrát adják vissza
• Ugyanazt a X-API-Key szervezeti scope-ot ellenőrzik
• Ugyanazokat a telephony configuration kiválasztási szabályokat használják

Ha kifejezetten az API Trigger route-ra van szüksége, tekintse meg a Kimenő Agent Run indítása API Trigger Node-dal útmutatót. Agent UUID-alapú végrehajtáshoz lásd: Kimenő Agent Run indítása Agent UUID-val.

Kezdeti kontextus használata

Az initial_context runtime adatokat ad át az Agentnek a Run során. Az értékek template variable-ként érhetők el az Agent promptjában, dupla kapcsos zárójeles szintaxissal.

{
  "initial_context": {
    "customer_name": "Jane",
    "appointment_date": "March 15"
  }
}

Az Agent promptja ezután hivatkozhat a {{customer_name}} és a {{appointment_date}} változókra; ezek a Run indításakor kapják meg értéküket.

Run állapotértékek

Állapot	Leírás
pending	A Run várakozik, de még nem kapcsolódott
in_progress	A Run folyamatban van
completed	A Run szabályosan befejeződött
failed	A Run végrehajtás előtt vagy közben meghiúsult