Začínáme s TeamDay

Vítejte v TeamDay! Tento quickstart průvodce vám umožní začít přibližně za 15 minut. Na konci budete mít:

  • ✅ Účet TeamDay s ověřením
  • ✅ Váš první osobní přístupový token (PAT)
  • ✅ Provedli jste první API volání
  • ✅ Vytvořili jste prvního AI agenta

Obsah

Krok 1: Registrace

Registrujte se na TeamDay

Možnost A: Registrace pomocí Google

  1. Navštivte https://us.teamday.ai
  2. Klikněte na “Registrovat se přes Google”
  3. Vyberte svůj Google účet
  4. Autorizujte TeamDay pro přístup k vašemu profilu

Možnost B: Registrace přes GitHub

  1. Navštivte https://us.teamday.ai
  2. Klikněte na “Registrovat se přes GitHub”
  3. Autorizujte aplikaci TeamDay
  4. Udělte požadovaná oprávnění

Možnost C: Registrace přes e-mail

  1. Navštivte https://us.teamday.ai
  2. Klikněte na “Registrovat se přes e-mail”
  3. Zadejte svou e-mailovou adresu
  4. Vytvořte bezpečné heslo (min. 8 znaků)
  5. Ověřte svou e-mailovou adresu

Doplňte svůj profil

Po registraci budete vyzváni k doplnění profilu:

  1. Jméno - Vaše celé jméno
  2. Společnost (volitelné) - Název vaší organizace
  3. Role (volitelné) - Vaše pracovní pozice

Klikněte na “Pokračovat” a pokračujte.

Krok 2: Vytvoření vaší organizace

Organizace vám pomáhají spravovat přístup týmu a fakturaci.

Nastavte vaši organizaci

  1. Název organizace - Vyberte popisný název
  2. ID organizace - Automaticky generovaný slug pro přístup API
  3. Plán fakturace - Začíná na volné úrovni

Klikněte na “Vytvořit organizaci” a pokračujte.

Krok 3: Vytvoření osobního přístupového tokenu

Osobní přístupové tokeny (PATs) vám umožňují ověřit požadavky API a příkazy CLI.

Přejděte na klíče API

  1. Klikněte na svou ikonu profilu v pravém horním rohu
  2. Vyberte “Nastavení”
  3. Klikněte na “API Klíče” v levém bočním panelu

Vytvořte svůj první token

  1. Klikněte na ”+ Nový osobní přístupový token”
  2. Nakonfigurujte token:
    • Jméno: “Token pro začínáme” (nebo jakýkoli popisný název)
    • Vypršení: Vyberte “90 dnů” (doporučeno pro testování)
    • Rozsahy: Úplný přístup (rozsahy již brzy)
  3. Klikněte na “Vytvořit token”

Bezpečně uložte svůj token

⚠️ DŮLEŽITÉ: Váš token se zobrazuje pouze jednou!

Proveďte ihned:

  1. Zkopírujte token do schránky
  2. Uložte jej bezpečně ve správci hesel nebo proměnné prostředí
  3. Nikdy ho nezavazujte do git a nesdílejte ho veřejně

Uložit do proměnné prostředí (doporučeno):

# macOS/Linux - Přidejte do ~/.bashrc nebo ~/.zshrc
export TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

# Windows PowerShell
$env:TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

Znovu načtěte shell:

source ~/.bashrc  # nebo source ~/.zshrc

Pokud ztratíte token: Musíte jej odvolat a vytvořit nový. Neexistuje způsob, jak získat ztracený token.

Krok 4: Provádění prvního API volání

Ověřme, že váš token funguje voláním TeamDay API.

Testujte své ověření

Pomocí cURL:

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

Očekávaná odpověď:

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

Měli byste vidět prázdný seznam (protože jste zatím nevytvořili žádné agenty).

Pomocí JavaScriptu:

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();

Pomocí Pythonu:

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()

Odstraňování potíží API volání

401 Neautorizováno:

  • Token je neplatný nebo vypršel
  • Zkontrolujte, že jste zkopírovali token správně
  • Ověřte, že token existuje v Settings → API Keys

403 Zakázáno:

  • Token nemá požadovaná oprávnění
  • Ověřte, že jste ve správné organizaci

Chyby sítě:

  • Zkontrolujte své internetové připojení
  • Ověřte správnost URL API: https://us.teamday.ai

Krok 5: Vytvoření prvního agenta

Nyní vytvořme AI agenta pomocí API.

Vytvořit agenta přes API

Požadavek:

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 první agent",
    "systemPrompt": "Jste užitečný asistent, který může odpovídat na otázky a pomáhat s úkoly. Buďte stručný a přátelský.",
    "model": "claude-sonnet-4-6",
    "visibility": "private"
  }'

Odpověď:

{
  "id": "char_abc123xyz",
  "name": "Můj první agent",
  "systemPrompt": "Jste užitečný asistent...",
  "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 potřebovat pro spuštění agenta.

Další kroky

Blahopřeji! Úspěšně jste:

  • ✅ Vytvořili účet TeamDay
  • ✅ Nastavili vaši organizaci
  • ✅ Vytvořili osobní přístupový token
  • ✅ Provedli první API volání
  • ✅ Vytvořili a testovali prvního AI agenta

Doporučené další kroky

1. Vytvořit speciálnějšího agenta

2. Nastavit pracovní prostor

  • Vytvořte prostor pro práci agenta se soubory a kódem
  • Průvodce: Nastavení Space

3. Připojte se k GitHub

  • Umožněte vašemu agentovi pracovat s vašimi úložišti
  • Průvodce: Git Integrace

4. Nainstalujte MCP Pluginy

  • Rozšiřte schopnosti vašeho agenta o nástroje a integrace
  • Průvodce: MCP Pluginy

5. Prozkoumejte API

Vzdělávací materiály

Získejte pomoc

Komunita:

Podpora:

Sdílejte svou zkušenost

Rádi bychom se dozvěděli o vaší první zkušenosti s TeamDay!

  • Sdílejte na Twitteru: @teamdayai
  • Zanechte zpětnou vazbu: feedback at teamday.ai

Šťastné budování! 🚀