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
- Krok 2: Vytvoření vaší organizace
- Krok 3: Vytvoření osobního přístupového tokenu
- Krok 4: Provádění prvního API volání
- Krok 5: Vytvoření prvního agenta
- Další kroky
Krok 1: Registrace
Registrujte se na TeamDay
Možnost A: Registrace pomocí Google
- Navštivte https://us.teamday.ai
- Klikněte na “Registrovat se přes Google”
- Vyberte svůj Google účet
- Autorizujte TeamDay pro přístup k vašemu profilu
Možnost B: Registrace přes GitHub
- Navštivte https://us.teamday.ai
- Klikněte na “Registrovat se přes GitHub”
- Autorizujte aplikaci TeamDay
- Udělte požadovaná oprávnění
Možnost C: Registrace přes e-mail
- Navštivte https://us.teamday.ai
- Klikněte na “Registrovat se přes e-mail”
- Zadejte svou e-mailovou adresu
- Vytvořte bezpečné heslo (min. 8 znaků)
- Ověřte svou e-mailovou adresu
Doplňte svůj profil
Po registraci budete vyzváni k doplnění profilu:
- Jméno - Vaše celé jméno
- Společnost (volitelné) - Název vaší organizace
- 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
- Název organizace - Vyberte popisný název
- ID organizace - Automaticky generovaný slug pro přístup API
- 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
- Klikněte na svou ikonu profilu v pravém horním rohu
- Vyberte “Nastavení”
- Klikněte na “API Klíče” v levém bočním panelu
Vytvořte svůj první token
- Klikněte na ”+ Nový osobní přístupový token”
- 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)
- 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:
- Zkopírujte token do schránky
- Uložte jej bezpečně ve správci hesel nebo proměnné prostředí
- 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
- Naučte se konfigurovat agenty se specifickými dovednostmi a znalostmi
- Průvodce: Vytvoření první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
- Naučte se pokročilé funkce API
- Reference: API Dokumentace
Vzdělávací materiály
- Odstraňování problémů - Běžné problémy a řešení
- API Reference - Kompletní dokumentace API
Získejte pomoc
Komunita:
- Discord komunita - Chat s ostatními uživateli
- GitHub Diskuse - Pokládejte otázky
Podpora:
- E-mail: support at teamday.ai
- Dokumentace: https://us.teamday.ai/docs
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í! 🚀