TeamDay.ai
← Docs

API Spuštění

Spuštění představují instance, kdy agenti běží. Každé spuštění zachycuje kompletní historii zpráv, použití nástrojů, výsledků a metrik výkonu. Použijte Executions API k monitorování aktivity agenta, sledování dokončení úkolů a analýze vzorců spuštění.

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

Ověřování: Osobní přístupový token vyžadován

Přehled endpointů

MetodaEndpointPopisStatus
GET/executionsVypsat spuštění🟡 Netestováno
GET/executions/[id]Získat detaily spuštění🟡 Netestováno
GET/executions/[id]/treeZískat strom spuštění (pod-agenti)🟡 Netestováno
POST/executions/[id]/cancelZrušit běžící spuštění🟡 Netestováno

Status implementace: Kompletní, ale netestované v produkci

Objekt Spuštění

Vlastnosti

{
  id: string              // ID spuštění (formát: exec_xxx)
  agentId: string         // Agent, který se spustil
  organizationId: string  // Organizace vlastníka
  userId: string          // Uživatel, který spuštění inicioval
  status: string          // "pending" | "running" | "completed" | "failed" | "cancelled"
  startedAt: string       // ISO 8601 časová značka
  completedAt?: string    // ISO 8601 časová značka (pokud je hotovo)
  messages: Message[]     // Historie konverzace
  toolCalls: ToolCall[]   // Nástroje použité během spuštění
  error?: string          // Chybová zpráva (pokud selhalo)
  metadata: object        // Další kontext spuštění
}

Pří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 tato prodejní data",
      "timestamp": "2025-12-09T10:30:00Z"
    },
    {
      "role": "assistant",
      "content": "Na základě analýzy prodejních dat...",
      "timestamp": "2025-12-09T10:30:45Z"
    }
  ],
  "toolCalls": [
    {
      "tool": "read_file",
      "arguments": { "path": "sales_data.csv" },
      "result": "Success",
      "timestamp": "2025-12-09T10:30:20Z"
    }
  ],
  "metadata": {
    "model": "claude-sonnet-4-6",
    "tokensUsed": 1234,
    "duration": 45000
  }
}

Vypsat spuštění

Načtěte historii spuštění vaší organizace, volitelně filtrovanou podle agenta.

Požadavek

GET /api/v1/executions

Záhlaví:

Authorization: Bearer td_xxxxx...

Parametry dotazu:

  • agentId (string, volitelné) - Filtrovat podle konkrétního agenta
  • limit (number, volitelné) - Maximální počet výsledků (výchozí: 50, max: 100)

Odpověď

Úspěch (200 OK):

[
  {
    "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",
    "metadata": {
      "model": "claude-sonnet-4-6",
      "duration": 45000
    }
  }
]

Příklad

curl https://us.teamday.ai/api/v1/executions \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Získat detaily spuštění

Načtěte kompletní detaily konkrétního spuštění, včetně úplné historie zpráv a volání nástrojů.

Požadavek

GET /api/v1/executions/[id]

Záhlaví:

Authorization: Bearer td_xxxxx...

Parametry cesty:

  • id (string) - ID spuštění (formát: exec_xxx)

Příklad

curl https://us.teamday.ai/api/v1/executions/exec_xyz789 \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Zrušit spuštění

Zastavte běžící spuštění. Pouze spuštění se stavem pending nebo running lze zrušit.

Požadavek

POST /api/v1/executions/[id]/cancel

Záhlaví:

Authorization: Bearer td_xxxxx...

Parametry cesty:

  • id (string) - ID spuštění (formát: exec_xxx)

Tělo: Žádné

Příklad

curl -X POST https://us.teamday.ai/api/v1/executions/exec_xyz789/cancel \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Stav spuštění

Spuštění probíhá následujícími stavy:

Čekající

Status: "pending"

Popis: Spuštění vytvořeno, ale ještě nezačalo. Čekání na zdroje nebo ve frontě.

Běžící

Status: "running"

Popis: Agent aktivně zpracovává. Může zahrnovat více volání nástrojů a požadavků API.

Dokončeno

Status: "completed"

Popis: Spuštění se zdařilo. Výsledky jsou k dispozici.

Selhalo

Status: "failed"

Popis: Spuštění narazilo na chybu a zastavilo se. Zkontrolujte pole error pro detaily.

Zrušeno

Status: "cancelled"

Popis: Spuštění bylo ručně zastaveno přes endpoint zrušení.

Nejlepší praktiky

Monitorování

Frekvence hlasování:

  • Běžící spuštění: 2-5 sekund
  • Dokončená spuštění: Bez hlasování potřeba (použijte webhooky, když budou dostupné)

Co sledovat:

  • Spuštění uvízlá v running > 5 minut
  • Vysoká míra selhání (> 10%)
  • Neobvyklé vzestupy užívání tokenů

Ukládání

Uchování spuštění:

  • Zachovejte nedávná spuštění (posledních 30 dnů) pro ladění
  • Archivujte starší spuštění pro soulad
  • Odstraňte citlivá data podle politiky uchování

Zpracování chyb

Běžné chyby

400 Chybný požadavek:

  • Pokus o zrušení dokončeného/selhávajícího spuštění
  • Neplatné parametry dotazu

401 Neautorizováno:

  • Chybějící Authorization záhlaví
  • Neplatný nebo vypršelý token

404 Nenalezeno:

  • ID spuštění neexistuje
  • Spuštění patří jiné organizaci

500 Interní chyba serveru:

  • Problémy s připojením k databázi
  • Služba dočasně není dostupná

Související zdroje

Potřebujete pomoc?

Problémy se spuštěním?

  • Zkontrolujte reference chyb pro odstraňování problémů
  • Sledujte stav spuštění a chybové zprávy
  • Použijte stromy spuštění k ladění delegace

Otázky?

Poslední aktualizace: 9. prosince 2025