TeamDay.ai
← Docs

Začíname s TeamDay

Vitajte v TeamDay! Tento sprievodca rýchlym štartom vás spustí za približne 15 minút. Na konci budete mať:

  • ✅ Účet TeamDay s autentifikáciou
  • ✅ Svoj prvý osobný prístupový token (PAT)
  • ✅ Vykonali svoju prvú požiadavku API
  • ✅ Vytvorili svého prvého AI agenta

Obsah

Krok 1: Registrácia

Registrácia pre TeamDay

Možnosť A: Registrácia cez Google

  1. Navštívte https://us.teamday.ai
  2. Kliknutie na “Registrácia cez Google”
  3. Vyberte váš účet Google
  4. Autorizujte TeamDay na prístup k vášmu profilu

Možnosť B: Registrácia cez GitHub

  1. Navštívte https://us.teamday.ai
  2. Kliknutie na “Registrácia cez GitHub”
  3. Autorizujte aplikáciu TeamDay
  4. Udeľte požadované povolenia

Možnosť C: Registrácia cez e-mail

  1. Navštívte https://us.teamday.ai
  2. Kliknutie na “Registrácia cez e-mail”
  3. Zadajte svoju e-mailovú adresu
  4. Vytvorte bezpečné heslo (min. 8 znakov)
  5. Overte svoju e-mailovú adresu

Snímka

Dokončenie vášho profilu

Po registrácii sa vás budeme ľutovať na dokončenie profilu:

  1. Meno - Vaše plné meno
  2. Spoločnosť (voliteľné) - Názov vašej organizácie
  3. Úloha (voliteľné) - Vaše pracovné zaradenie

Kliknutie na “Pokračovať” aby ste pokračovali.

Snímka

Krok 2: Vytvorenie organizácie

Organizácie vám pomáhajú spravovať prístup tímu a fakturáciu.

Nastavenie vašej organizácie

  1. Názov organizácie - Vyberte popisný názov

    • Príklad: “Acme Corp”, “Môj startup”, “Osobné projekty”

  2. ID organizácie - Automaticky vygenerovaný slug na prístup k API

    • Príklad: acme-corp, my-startup
    • Dá sa prispôsobiť (malé písmená, iba spojovníky)

  3. Plán fakturácie - Začína na bezplatnej úrovni

    • Bezplatné: 100 vykonávaní agenta/mesiac
    • Pro: Neobmedzené vykonávania ($29/mesiac)
    • Enterprise: Vlastná cenotvorba

Kliknutie na “Vytvoriť organizáciu” aby ste pokračovali.

Snímka

Poznámka: Neskôr si môžete vytvoriť viacero organizácií alebo sa pripojiť k existujúcim z nastavení.

Krok 3: Vytvorenie osobného prístupového tokenu

Osobné prístupové tokeny (PAT) vám umožňujú autentifikovať požiadavky API a príkazy CLI.

Prejdite na kľúče API

  1. Kliknutie na ikonku profilu v pravom hornom rohu
  2. Vyberte “Nastavenia”
  3. Kliknutie na “Kľúče API” v ľavom bočnom paneli

Snímka

Vytvorenie vášho prvého tokenu

  1. Kliknutie na ”+ Nový osobný prístupový token”

  2. Konfigurácia tokenu:

    • Meno: “Token na začíname” (alebo akýkoľvek popisný názov)
    • Vypršanie: Vyberte “90 dní” (odporúčané na testovanie)
    • Rozsahy: Úplný prístup (rozsahy čoskoro)

  3. Kliknutie na “Vytvoriť token”

Snímka

Bezpečné uloženie vášho tokenu

⚠️ DÔLEŽITÉ: Váš token sa zobrazuje iba raz!

td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Vykonajte to okamžite:

  1. Skopírujte token do schránky
  2. Uložte ho bezpečne v manažéri hesiel alebo premennej prostredia
  3. Nikdy ho nepoužívajte do git alebo ho zdieľajte verejne

Uloženie do premennej prostredia (odporúčané):

# macOS/Linux - Pridajte do ~/.bashrc alebo ~/.zshrc
export TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

# Windows PowerShell
$env:TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

Znovu načítajte shell:

source ~/.bashrc  # alebo source ~/.zshrc

Snímka

Ak stratíte token: Musíte ho odvolať a vytvoriť nový. Stratený token nie je možné obnoviť.

Krok 4: Vykonanie prvej požiadavky API

Poďme overiť, že váš token funguje zavolaním API TeamDay.

Testovanie vašej autentifikácie

Pomocou cURL:

curl -X GET "https://us.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json"

Očakávaná odozva:

{
  "data": [],
  "count": 0
}

Mali by ste vidieť prázdny zoznam (keďže ste zatiaľ nevytvorili žiadnych agentov).

Snímka

Pomocou JavaScript:

const TEAMDAY_TOKEN = process.env.TEAMDAY_API_TOKEN;

async function listAgents() {
  const response = await fetch('https://us.teamday.ai/api/v1/agents', {
    headers: {
      'Authorization': `Bearer ${TEAMDAY_TOKEN}`,
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  console.log('Agenti:', data);
}

listAgents();

Pomocou Python:

import os
import requests

TEAMDAY_TOKEN = os.environ['TEAMDAY_API_TOKEN']

def list_agents():
    response = requests.get(
        'https://us.teamday.ai/api/v1/agents',
        headers={
            'Authorization': f'Bearer {TEAMDAY_TOKEN}',
            'Content-Type': 'application/json'
        }
    )
    print('Agenti:', response.json())

list_agents()

Riešenie problémov s požiadavkami API

401 Neoprávnené:

  • Token je neplatný alebo expirovaný
  • Skontrolujte, že ste token skopírovali správne
  • Overte, že token existuje v Nastaveniach → Kľúče API

403 Zakázané:

  • Token nemá požadované povolenia
  • Overte, že ste v správnej organizácii

Chyby siete:

  • Skontrolujte internetové pripojenie
  • Overte, že je URL API správne: https://us.teamday.ai

Krok 5: Vytvorenie prvého agenta

Teraz poďme vytvoriť AI agenta pomocou API.

Vytvorenie agenta cez API

Požiadavka:

curl -X POST "https://us.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Môj prvý agent",
    "systemPrompt": "Ste užitočný pomocník, ktorý dokáže odpovedať na otázky a pomáhať s úlohami. Buďte stručný a priateľský.",
    "model": "claude-sonnet-4-6",
    "visibility": "private"
  }'

Odozva:

{
  "id": "char_abc123xyz",
  "name": "Môj prvý agent",
  "systemPrompt": "Ste užitočný pomocník...",
  "model": "claude-sonnet-4-6",
  "visibility": "private",
  "organizationId": "org_xyz789",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T10:00:00Z"
}

Uložte ID agenta (char_abc123xyz) - budete ho potrebovať na vykonanie agenta.

Snímka

Vytvorenie agenta cez rozhranie

Uprednostňujete vizuálne rozhranie?

  1. Prejdite na “Agenti” v bočnom paneli
  2. Kliknutie na ”+ Nový agent”
  3. Vyplňte podrobnosti:
    • Meno: “Môj prvý agent”
    • Model: Vyberte “Claude 3.5 Sonnet”
    • Systémový pokyn: Zadajte pokyny vyššie
    • Viditeľnosť: Vyberte “Súkromné”
  4. Kliknutie na “Vytvoriť agenta”

Snímka

Testovanie vášho agenta

Vykonanie cez API:

curl -X POST "https://us.teamday.ai/api/v1/agents/char_abc123xyz/execute" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Ahoj! S čím mi môžeš pomôcť?"
  }'

Odozva:

{
  "executionId": "exec_456def",
  "message": "Ahoj! Som váš užitočný pomocník. Môžem vám pomôcť s celou radou úloh vrátane odpovedania na otázky, poskytovania informácií, pomoci s analýzou a ďalšom. S čím by ste chceli pomôcť?",
  "usage": {
    "inputTokens": 245,
    "outputTokens": 89
  },
  "status": "completed"
}

Snímka

Vykonanie cez rozhranie:

  1. Prejdite na “Agenti” → “Môj prvý agent”
  2. Kliknutie na “Chat”
  3. Zadajte správu: “Ahoj! S čím mi môžeš pomôcť?”
  4. Stlačte Enter alebo kliknutie na Odoslať
  5. Zobrazte odpoveď agenta

Snímka

Ďalšie kroky

Blahoželáme! Úspešne ste:

  • ✅ Vytvorili svoj účet TeamDay
  • ✅ Nastavili svoju organizáciu
  • ✅ Vygenerovali osobný prístupový token
  • ✅ Vykonali svoju prvú požiadavku API
  • ✅ Vytvorili a otestovali svojho prvého AI agenta

Odporúčané ďalšie kroky

1. Vytvorenie špecializovanejšieho agenta

2. Nastavenie pracovného prostredia

3. Pripojenie k GitHub

  • Umožnenie agentovi pracovať s vašimi úložiskami
  • Príručka: Integrácia Git

4. Inštalácia MCP pluginov

  • Rozšírenie možností agenta nástrojmi a integráciami
  • Príručka: MCP pluginy

5. Preskúmanie API

Vzdelávacie zdroje

Získavanie pomoci

Komunita:

Podpora:

Zdieľajte svoju skúsenosť

Chceli by sme počuť o vašej prvej skúsenosti s TeamDay!

  • Zdieľajte na Twitteri: @teamdayai
  • Zanechajte spätno: feedback at teamday.ai

Šťastné budovanie! 🚀