TeamDay API v1 - Přehled

TeamDay API umožňuje vývojářům programově interagovat s platformou TeamDay AI. Vytvářejte vlastní integrace, automatizujte pracovní postupy a spravujte AI agenty prostřednictvím jednoduchého REST API.

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

Aktuální status: 87.5% funkčnosti (7 z 8 testovaných endpointů funguje)

Rychlý start

# 1. Získejte váš API token z Settings → API Access
export TEAMDAY_TOKEN="td_your_token_here"

# 2. Proveďte svůj první požadavek
curl https://cc.teamday.ai/api/v1/agents \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Skupiny API

TeamDay v1 API je organizováno do následujících skupin zdrojů:

Ověřování

Všechny požadavky API vyžadují osobní přístupový token (PAT) předaný v hlavičce Authorization:

Authorization: Bearer td_xxxxx...

Získejte váš token:

1. Přihlaste se na TeamDay
2. Přejděte na Settings → API Access
3. Klikněte na Generate New Token
4. Zkopírujte a bezpečně uložte (zobrazeno pouze jednou)

Další informace o ověřování →

Základní koncepty

Agenti

Agenti jsou AI asistenti s přizpůsobitelným systémem promptů, rolemi a schopnostmi. Vytvářejte agenty k automatizaci úkolů, analýze dat nebo asistenci s pracovními postupy.

Příklad:

# Vytvořit nového agenta
curl -X POST https://cc.teamday.ai/api/v1/agents \
  -H "Authorization: Bearer $TEAMDAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Výzkumný asistent",
    "role": "Výzkum a analýza",
    "systemPrompt": "Jste výzkumný asistent...",
    "visibility": "private"
  }'

Zobrazit úplnou dokumentaci agenta →

Spuštění

Spuštění sledují, když agenti běží. Každé spuštění zachycuje úplnou historii zpráv, použití nástrojů a výsledků.

Příklad:

# Vypsat nedávná spuštění
curl https://cc.teamday.ai/api/v1/executions?limit=10 \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Zobrazit úplnou dokumentaci spuštění →

Úkoly

Úkoly představují pracovní položky přiřazené agentům nebo uživatelům. Úkoly lze filtrovat podle stavu, příjemce a pracovního prostoru.

Příklad:

# Vypsat nevyřešené úkoly
curl https://cc.teamday.ai/api/v1/tasks?status=pending \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Zobrazit úplnou dokumentaci úkolů →

Formát odpovědi

Všechny odpovědi mají konzistentní strukturu JSON:

Úspěšná odpověď

{
  "id": "agent_123",
  "name": "Výzkumný asistent",
  "createdAt": "2025-12-09T12:00:00Z",
  "...": "..."
}

Chybová odpověď

{
  "error": true,
  "statusCode": 400,
  "statusMessage": "Bad Request",
  "message": "Chybí povinné pole: name"
}

Zobrazit reference chyb →

Omezení sazby

V současné době API nevynucuje omezení sazby. To se v budoucnosti může změnit. Osvědčené postupy:

• Používejte rozumné sazby požadavků
• Implementujte exponenciální zpětné zpoždění pro opakované pokusy
• Ukládat do mezipaměti odpovědi, je-li vhodné
• Zvažte webhooky pro aktualizace v reálném čase (již brzy)

Stránkování

Koncové body seznamu podporují stránkování prostřednictvím parametrů dotazu:

# Získat 50 výsledků (výchozí limit)
curl https://cc.teamday.ai/api/v1/executions \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

# Zadat vlastní limit
curl https://cc.teamday.ai/api/v1/executions?limit=100 \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Parametry:

• limit - Maximální počet výsledků na požadavek (výchozí: 50)

Filtrování

Většina koncových bodů seznamu podporuje filtrování prostřednictvím parametrů dotazu:

# Filtrovat spuštění podle agenta
curl "https://cc.teamday.ai/api/v1/executions?agentId=agent_123" \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

# Filtrovat úkoly podle stavu a prostoru
curl "https://cc.teamday.ai/api/v1/tasks?status=pending&spaceId=space_456" \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Dostupné filtry najdete v dokumentaci jednotlivých endpointů.

Datové typy

Časové značky

Všechny časové značky jsou řetězce ISO 8601 v UTC:

{
  "createdAt": "2025-12-09T12:00:00Z",
  "updatedAt": "2025-12-09T14:30:00Z"
}

IDs

Zdroje používají řetězce ID s předponami pro bezpečnost typů:

• agent_ - ID agentů
• exec_ - ID spuštění
• task_ - ID úkolů
• space_ - ID prostorů
• org_ - ID organizací
• td_ - Osobní přístupové tokeny

Viditelnost

Agenti a zdroje podporují tři úrovně viditelnosti:

• private - Viditelné pouze tvůrci
• organization - Viditelné členům organizace
• public - Viditelné všem (budoucí)

Známé problémy

Spuštění agenta (NEFUNGUJE)

Status: 🔴 Kritický problém

Endpoint /api/v1/agents/[id]/execute aktuálně vrací 500 chybu kvůli vnitřnímu problému služby. Na opravě aktivně pracujeme.

Dočasné řešení: Používejte webové rozhraní pro spuštění agenta, dokud to nebude vyřešeno.

Ovlivněné endpointy:

• POST /api/v1/agents/[id]/execute

Sledovat status problému →

Protokol API

9. prosince 2025

Status:

• ✅ 7/8 testovaných endpointů funguje (87.5%)
• 🔴 Endpoint spuštění agenta dočasně není k dispozici
• 🟡 Další endpointy netestovány (úkoly, spuštění)

Ověřování:

• ✅ Systém PAT tokenů plně funkční
• ✅ Ověřování SHA-256 hash
• ✅ Šifrování AES-256-GCM v klidovém stavu
• ✅ Automatické zpracování vypršení (7-365 dnů)

Agent CRUD:

• ✅ Vypsat agenty
• ✅ Vytvořit agenta
• ✅ Získat detaily agenta
• ✅ Aktualizovat agenta
• ✅ Smazat agenta (měkké smazání)

Podpora a komunita

Dokumentace:

• API Reference
• Nejlepší praktiky
• Příklady

Potřebujete pomoc?

• 📧 E-mail: [email protected]
• 💬 Discord: Připojit se ke komunitě
• 🐛 Problémy: GitHub

Další kroky

1. Ověřit se - Vygenerujte váš API token
2. Vytvořit agenta - Vytvořte svého prvního AI asistenta
3. Zobrazit příklady - Podívejte se na případy použití v reálném světě
4. Naučit se osvědčené postupy - Optimalizujte svou integraci

Poslední aktualizace: 9. prosince 2025