TeamDay.ai
← Docs

Erste Schritte mit TeamDay

Willkommen bei TeamDay! Diese Schnellstartanleitung hilft Ihnen, in etwa 15 Minuten loszulegen. Am Ende haben Sie:

  • ✅ Ein TeamDay-Konto mit Authentifizierung
  • ✅ Ihr erstes Personal Access Token (PAT)
  • ✅ Ihren ersten API-Aufruf getätigt
  • ✅ Ihren ersten KI-Agent erstellt

Inhaltsverzeichnis

Schritt 1: Registrieren

Registrieren Sie sich bei TeamDay

Option A: Mit Google registrieren

  1. Besuchen Sie https://us.teamday.ai
  2. Klicken Sie auf “Mit Google registrieren”
  3. Wählen Sie Ihr Google-Konto aus
  4. Autorisieren Sie TeamDay, auf Ihr Profil zuzugreifen

Option B: Mit GitHub registrieren

  1. Besuchen Sie https://us.teamday.ai
  2. Klicken Sie auf “Mit GitHub registrieren”
  3. Autorisieren Sie die TeamDay-Anwendung
  4. Gewähren Sie die angeforderten Berechtigungen

Option C: Mit E-Mail registrieren

  1. Besuchen Sie https://us.teamday.ai
  2. Klicken Sie auf “Mit E-Mail registrieren”
  3. Geben Sie Ihre E-Mail-Adresse ein
  4. Erstellen Sie ein sicheres Passwort (mindestens 8 Zeichen)
  5. Verifizieren Sie Ihre E-Mail-Adresse

Screenshot

Vervollständigen Sie Ihr Profil

Nach der Registrierung werden Sie aufgefordert, Ihr Profil zu vervollständigen:

  1. Name - Ihr vollständiger Name
  2. Unternehmen (optional) - Name Ihrer Organisation
  3. Rolle (optional) - Ihr Jobtitel oder Ihre Rolle

Klicken Sie auf “Fortfahren”, um fortzufahren.

Screenshot

Schritt 2: Erstellen Sie Ihre Organisation

Organisationen helfen Ihnen, den Teamzugriff und die Abrechnung zu verwalten.

Richten Sie Ihre Organisation ein

  1. Organisationsname - Wählen Sie einen aussagekräftigen Namen

    • Beispiel: “Acme Corp”, “Mein Startup”, “Persönliche Projekte”

  2. Organisations-ID - Auto-generierter Slug für API-Zugriff

    • Beispiel: acme-corp, my-startup
    • Kann angepasst werden (Kleinbuchstaben, nur Bindestriche)

  3. Abrechnungsplan - Startet im kostenlosen Tarif

    • Kostenlos: 100 Agent-Ausführungen pro Monat
    • Pro: Unbegrenzte Ausführungen (29 $/Monat)
    • Enterprise: Individuelle Preisgestaltung

Klicken Sie auf “Organisation erstellen”, um fortzufahren.

Screenshot

Hinweis: Sie können später mehrere Organisationen erstellen oder über Ihre Einstellungen vorhandenen beitreten.

Schritt 3: Erstellen Sie ein Personal Access Token

Personal Access Tokens (PATs) ermöglichen Ihnen die Authentifizierung von API-Anfragen und CLI-Befehlen.

  1. Klicken Sie auf Ihr Profilsymbol in der oberen rechten Ecke
  2. Wählen Sie “Einstellungen”
  3. Klicken Sie auf “API-Schlüssel” in der linken Seitenleiste

Screenshot

Erstellen Sie Ihren ersten Token

  1. Klicken Sie auf ”+ Neues Personal Access Token”

  2. Konfigurieren Sie den Token:

    • Name: “Getting Started Token” (oder ein beliebiger aussagekräftiger Name)
    • Ablauf: Wählen Sie “90 Tage” (empfohlen zum Testen)
    • Scopes: Vollständiger Zugriff (Scopes erscheinen bald)

  3. Klicken Sie auf “Token erstellen”

Screenshot

Speichern Sie Ihren Token sicher

⚠️ WICHTIG: Ihr Token wird nur einmal angezeigt!

td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Tun Sie dies sofort:

  1. Kopieren Sie den Token in Ihre Zwischenablage
  2. Speichern Sie ihn sicher in einem Passwort-Manager oder einer Umgebungsvariablen
  3. Commiten Sie ihn niemals in Git und teilen Sie ihn nicht öffentlich

Speichern Sie in einer Umgebungsvariablen (empfohlen):

# macOS/Linux - Zu ~/.bashrc oder ~/.zshrc hinzufügen
export TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

# Windows PowerShell
$env:TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

Laden Sie Ihre Shell neu:

source ~/.bashrc  # oder source ~/.zshrc

Screenshot

Wenn Sie Ihren Token verlieren: Sie müssen ihn widerrufen und einen neuen erstellen. Es gibt keine Möglichkeit, einen verlorenen Token abzurufen.

Schritt 4: Tätigen Sie Ihren ersten API-Aufruf

Lassen Sie uns überprüfen, ob Ihr Token funktioniert, indem Sie die TeamDay API aufrufen.

Testen Sie Ihre Authentifizierung

Mit cURL:

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

Erwartete Antwort:

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

Sie sollten eine leere Liste sehen (da Sie noch keine Agents erstellt haben).

Screenshot

Mit 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('Agents:', data);
}

listAgents();

Mit 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('Agents:', response.json())

list_agents()

Fehlerbehebung für API-Aufrufe

401 Unauthorized:

  • Token ist ungültig oder abgelaufen
  • Überprüfen Sie, ob Sie den Token korrekt kopiert haben
  • Verifizieren Sie, dass der Token unter Einstellungen → API-Schlüssel vorhanden ist

403 Forbidden:

  • Token hat keine erforderlichen Berechtigungen
  • Überprüfen Sie, ob Sie sich in der richtigen Organisation befinden

Netzwerkfehler:

  • Überprüfen Sie Ihre Internetverbindung
  • Überprüfen Sie, ob die API-URL korrekt ist: https://us.teamday.ai

Schritt 5: Erstellen Sie Ihren ersten Agent

Jetzt erstellen wir einen KI-Agent über die API.

Agent über API erstellen

Anfrage:

curl -X POST "https://us.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mein erster Agent",
    "systemPrompt": "Du bist ein hilfreicher Assistent, der Fragen beantworten und bei Aufgaben helfen kann. Seien Sie prägnant und freundlich.",
    "model": "claude-sonnet-4-6",
    "visibility": "private"
  }'

Antwort:

{
  "id": "char_abc123xyz",
  "name": "Mein erster Agent",
  "systemPrompt": "Du bist ein hilfreicher Assistent...",
  "model": "claude-sonnet-4-6",
  "visibility": "private",
  "organizationId": "org_xyz789",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T10:00:00Z"
}

Speichern Sie die Agent-ID (char_abc123xyz) - Sie werden sie benötigen, um den Agent auszuführen.

Screenshot

Agent über Benutzeroberfläche erstellen

Bevorzugen Sie eine visuelle Schnittstelle?

  1. Navigieren Sie zu “Agents” in der Seitenleiste
  2. Klicken Sie auf ”+ Neuer Agent”
  3. Füllen Sie die Details aus:
    • Name: “Mein erster Agent”
    • Model: Wählen Sie “Claude 3.5 Sonnet”
    • System Prompt: Geben Sie die obigen Anweisungen ein
    • Sichtbarkeit: Wählen Sie “Privat”
  4. Klicken Sie auf “Agent erstellen”

Screenshot

Testen Sie Ihren Agent

Über API ausführen:

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": "Hallo! Wobei kannst du mir helfen?"
  }'

Antwort:

{
  "executionId": "exec_456def",
  "message": "Hallo! Ich bin dein hilfreicher Assistent. Ich kann dir bei einer Vielzahl von Aufgaben helfen, einschließlich Beantwortung von Fragen, Bereitstellung von Informationen, Hilfe bei der Analyse und mehr. Womit kann ich dir heute helfen?",
  "usage": {
    "inputTokens": 245,
    "outputTokens": 89
  },
  "status": "completed"
}

Screenshot

Über Benutzeroberfläche ausführen:

  1. Navigieren Sie zu “Agents” → “Mein erster Agent”
  2. Klicken Sie auf “Chat”
  3. Geben Sie Ihre Nachricht ein: “Hallo! Womit kannst du mir helfen?”
  4. Drücken Sie Enter oder klicken Sie auf Senden
  5. Sehen Sie sich die Antwort des Agents an

Screenshot

Nächste Schritte

Herzlichen Glückwunsch! Sie haben erfolgreich:

  • ✅ Ihr TeamDay-Konto erstellt
  • ✅ Ihre Organisation eingerichtet
  • ✅ Ein Personal Access Token generiert
  • ✅ Ihren ersten API-Aufruf getätigt
  • ✅ Ihren ersten KI-Agent erstellt und getestet

Empfohlene nächste Schritte

1. Erstellen Sie einen spezialisierteren Agent

2. Richten Sie einen Workspace ein

  • Erstellen Sie einen Space, damit Ihr Agent mit Dateien und Code arbeiten kann
  • Anleitung: Space Setup

3. Verbinden Sie sich mit GitHub

  • Aktivieren Sie, damit Ihr Agent mit Ihren Repositories arbeitet
  • Anleitung: Git-Integration

4. Installieren Sie MCP-Plugins

  • Erweitern Sie die Funktionen Ihres Agents mit Tools und Integrationen
  • Anleitung: MCP-Plugins

5. Erkunden Sie die API

Lernressourcen

Hilfe erhalten

Gemeinschaft:

Unterstützung:

Teilen Sie Ihre Erfahrung

Wir würden gerne von Ihren ersten Erfahrungen mit TeamDay erfahren!

  • Teilen Sie auf Twitter: @teamdayai
  • Hinterlassen Sie Feedback: feedback at teamday.ai

Viel Spaß beim Bauen! 🚀