TeamDay.ai
← Docs

API agentov

Agenti sú prispôsobiteľní AI asistenti, ktorí môžu vykonávať úlohy, analyzovať údaje a automatizovať pracovné toky. Použite API agentov na programatické vytvorenie a správu agentov pre vašu organizáciu.

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

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

Prehľad koncových bodov

MetódaKoncový bodPopisStav
GET/agentsZoznam všetkých agentov✅ Fungujúce
POST/agentsVytvorenie nového agenta✅ Fungujúce
GET/agents/[id]Získanie podrobností agenta✅ Fungujúce
PATCH/agents/[id]Aktualizácia agenta✅ Fungujúce
DELETE/agents/[id]Vymazanie agenta✅ Fungujúce
POST/agents/[id]/executeVykonanie agenta🔴 Nefungujúce (chyba 500)

Výsledky testov: 5/6 koncových bodov operačných (83%)

Objekt agenta

Vlastnosti

{
  id: string              // ID agenta (formát: agent_xxx)
  name: string            // Zobrazené meno
  role: string            // Úloha agenta
  systemPrompt: string    // Systémové pokyny
  visibility: string      // "private" | "organization" | "public"
  organizationId: string  // Vlastník organizácia
  userId: string          // ID tvorcu používateľa
  createdAt: string       // ISO 8601 časová pečiatka
  updatedAt: string       // ISO 8601 časová pečiatka
  deletedAt?: string      // Časová pečiatka mäkkého vymazania (ak vymazané)
}

Príklad objektu

{
  "id": "agent_abc123",
  "name": "Pomocník pre výskum",
  "role": "Výskum a analýza údajov",
  "systemPrompt": "Ste užitočný pomocník pre výskum špecializujúci sa na analýzu a zhrnutie údajov.",
  "visibility": "private",
  "organizationId": "org_xyz789",
  "userId": "user_456",
  "createdAt": "2025-12-09T10:30:00Z",
  "updatedAt": "2025-12-09T10:30:00Z"
}

Zoznam agentov

Načítajte všetky agenti pre vašu organizáciu.

Požiadavka

GET /api/v1/agents

Hlavičky:

Authorization: Bearer td_xxxxx...

Odozva

{
  "agents": [
    {
      "id": "agent_abc123",
      "name": "Recenzent kódu",
      "role": "Starší vývojár",
      "systemPrompt": "Recenzujete kód na kvalitu...",
      "visibility": "private",
      "organizationId": "org_xyz789",
      "createdAt": "2024-12-09T10:00:00Z"
    }
  ]
}

Vytvorenie agenta

Vytvorte nového AI agenta.

Požiadavka

POST /api/v1/agents

Telo:

{
  "name": "Pomocník pre výskum",
  "role": "Výskumný pracovník",
  "systemPrompt": "Ste užitočný pomocník pre výskum.",
  "visibility": "organization",
  "model": "claude-sonnet-4-6"
}

Odozva

{
  "id": "agent_new123",
  "name": "Pomocník pre výskum",
  "role": "Výskumný pracovník",
  "systemPrompt": "Ste užitočný pomocník pre výskum.",
  "visibility": "organization",
  "organizationId": "org_xyz789",
  "createdAt": "2025-12-09T10:30:00Z",
  "updatedAt": "2025-12-09T10:30:00Z"
}

Aktualizácia agenta

Aktualizujte existujúceho agenta.

Požiadavka

PATCH /api/v1/agents/{agentId}

Telo:

{
  "name": "Aktualizované meno",
  "systemPrompt": "Nový pokyn..."
}

Vymazanie agenta

Vymazanie agenta (měkké vymazanie).

Požiadavka

DELETE /api/v1/agents/{agentId}

Vykonanie agenta

Spustite agenta (v súčasnosti nefunguje - chyba 500).

Požiadavka

POST /api/v1/agents/{agentId}/execute

Telo:

{
  "message": "Vaša správa",
  "spaceId": "space_abc123"
}

Status: 🔴 Nefungujúce - Interný problém

Chybové kódy

  • 400 - Chybná požiadavka (chýbajúce pole, neplatná hodnota)
  • 401 - Neoprávnené (chýba token alebo je neplatný)
  • 403 - Zakázané (nedostatočné povolenia)
  • 404 - Nenájdené (agent neexistuje)
  • 500 - Chyba servera (skúste vykonanie cez web rozhranie)