API vykonávaní

Vykonávania predstavujú inštancie, keď sa agenti spustia. Každé vykonanie zachytáva úplnú históriu správ, použitia nástrojov, výsledkov a metrík výkonu. Použite API vykonávaní na monitorovanie aktivity agentov, sledovanie dokončenia úloh a analýzu vzorov vykonávania.

Základný URL: https://us.teamday.ai/api/v1/executions

Autentifikácia: Vyžaduje sa osobný prístupový token

---

Prehľad koncových bodov

Metóda	Koncový bod	Popis	Stav
GET	/executions	Zoznam vykonávaní	🟡 Netestované
GET	/executions/[id]	Získanie podrobností vykonania	🟡 Netestované
GET	/executions/[id]/tree	Získanie stromu vykonávania (podagenti)	🟡 Netestované
POST	/executions/[id]/cancel	Zrušenie spusteného vykonávania	🟡 Netestované

Stav implementácie: Dokončené, ale netestované v produkcii

---

Objekt vykonávania

Vlastnosti

{
  id: string              // ID vykonávania (formát: exec_xxx)
  agentId: string         // Agent, ktorý sa spustil
  organizationId: string  // Vlastník organizácia
  userId: string          // Používateľ, ktorý spustil vykonanie
  status: string          // "pending" | "running" | "completed" | "failed" | "cancelled"
  startedAt: string       // ISO 8601 časová pečiatka
  completedAt?: string    // ISO 8601 časová pečiatka (ak skončené)
  messages: Message[]     // História konverzácie
  toolCalls: ToolCall[]   // Nástroje použité počas vykonávania
  error?: string          // Chybová správa (ak zlyhalo)
  metadata: object        // Ďalší kontext vykonávania
}

Príklad objektu

{
  "id": "exec_xyz789",
  "agentId": "agent_abc123",
  "organizationId": "org_456",
  "userId": "user_789",
  "status": "completed",
  "startedAt": "2025-12-09T10:30:00Z",
  "completedAt": "2025-12-09T10:30:45Z",
  "messages": [
    {
      "role": "user",
      "content": "Analyzujte toto"
    }
  ]
}

---

Zoznam vykonávaní

Načítajte vykonávania pre agenta.

Požiadavka

GET /api/v1/executions?agentId={agentId}

Odozva

{
  "executions": [
    {
      "id": "exec_123",
      "agentId": "agent_abc",
      "status": "completed",
      "startedAt": "2025-12-09T10:30:00Z",
      "completedAt": "2025-12-09T10:30:45Z"
    }
  ]
}

---

Získanie podrobností vykonávania

Načítajte podrobnosti konkrétneho vykonávania.

Požiadavka

GET /api/v1/executions/{executionId}

Odozva

{
  "id": "exec_xyz789",
  "agentId": "agent_abc123",
  "status": "completed",
  "startedAt": "2025-12-09T10:30:00Z",
  "completedAt": "2025-12-09T10:30:45Z",
  "messages": []
}

---

Zrušenie vykonávania

Zrušte spustené vykonanie.

Požiadavka

POST /api/v1/executions/{executionId}/cancel

Odozva

{
  "id": "exec_xyz789",
  "status": "cancelled"
}