TeamDay.ai
← Docs

Premiers pas avec TeamDay

Bienvenue dans TeamDay ! Ce guide de démarrage rapide vous permettra d’être opérationnel en environ 15 minutes. À la fin, vous aurez :

  • ✅ Un compte TeamDay avec authentification
  • ✅ Votre premier Token d’accès personnel (PAT)
  • ✅ Fait votre premier appel API
  • ✅ Créé votre premier agent IA

Table des matières

Étape 1 : S’inscrire

S’inscrire à TeamDay

Option A : S’inscrire avec Google

  1. Visitez https://us.teamday.ai
  2. Cliquez sur “S’inscrire avec Google”
  3. Sélectionnez votre compte Google
  4. Autorisez TeamDay à accéder à votre profil

Option B : S’inscrire avec GitHub

  1. Visitez https://us.teamday.ai
  2. Cliquez sur “S’inscrire avec GitHub”
  3. Autorisez l’application TeamDay
  4. Accordez les permissions demandées

Option C : S’inscrire avec e-mail

  1. Visitez https://us.teamday.ai
  2. Cliquez sur “S’inscrire par e-mail”
  3. Entrez votre adresse e-mail
  4. Créez un mot de passe sécurisé (min. 8 caractères)
  5. Vérifiez votre adresse e-mail

Screenshot

Complétez votre profil

Après votre inscription, vous serez invité à compléter votre profil :

  1. Nom - Votre nom complet
  2. Entreprise (optionnel) - Nom de votre organisation
  3. Rôle (optionnel) - Votre titre ou rôle

Cliquez sur “Continuer” pour procéder.

Screenshot

Étape 2 : Créer votre organisation

Les organisations vous aident à gérer l’accès aux équipes et la facturation.

Configurer votre organisation

  1. Nom de l’organisation - Choisissez un nom descriptif

    • Exemple : “Acme Corp”, “Ma Startup”, “Projets personnels”

  2. ID d’organisation - Identifiant généré automatiquement pour l’accès API

    • Exemple : acme-corp, ma-startup
    • Peut être personnalisé (minuscules, tirets uniquement)

  3. Plan de facturation - Commence au niveau gratuit

    • Gratuit : 100 exécutions d’agents/mois
    • Pro : Exécutions illimitées (29 $/mois)
    • Entreprise : Tarification personnalisée

Cliquez sur “Créer une organisation” pour continuer.

Screenshot

Note : Vous pouvez créer plusieurs organisations ou en rejoindre d’autres plus tard depuis vos paramètres.

Étape 3 : Créer un token d’accès personnel

Les tokens d’accès personnels (PATs) vous permettent d’authentifier les demandes API et les commandes CLI.

  1. Cliquez sur votre icône de profil dans le coin supérieur droit
  2. Sélectionnez “Paramètres”
  3. Cliquez sur “Clés API” dans la barre latérale gauche

Screenshot

Créer votre premier token

  1. Cliquez sur ”+ Nouveau token d’accès personnel”

  2. Configurez le token :

    • Nom : “Token de démarrage” (ou tout nom descriptif)
    • Expiration : Sélectionnez “90 jours” (recommandé pour les tests)
    • Scopes : Accès complet (scopes à venir)

  3. Cliquez sur “Créer le token”

Screenshot

Sauvegardez votre token de manière sécurisée

⚠️ IMPORTANT : Votre token ne s’affiche qu’une fois !

td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Faites ceci immédiatement :

  1. Copiez le token dans votre presse-papiers
  2. Stockez-le de manière sécurisée dans un gestionnaire de mots de passe ou une variable d’environnement
  3. Ne l’engagez jamais sur git et ne le partagez pas publiquement

Enregistrez dans une variable d’environnement (recommandé) :

# macOS/Linux - Ajoutez à ~/.bashrc ou ~/.zshrc
export TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

# Windows PowerShell
$env:TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

Rechargez votre shell :

source ~/.bashrc  # ou source ~/.zshrc

Screenshot

Si vous perdez votre token : Vous devez le révoquer et en créer un nouveau. Il n’y a aucun moyen de récupérer un token perdu.

Étape 4 : Faire votre premier appel API

Vérifions que votre token fonctionne en appelant l’API TeamDay.

Testez votre authentification

Avec cURL :

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

Réponse attendue :

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

Vous devriez voir une liste vide (puisque vous n’avez pas encore créé d’agents).

Screenshot

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

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

Dépannage des appels API

401 Non autorisé :

  • Le token est invalide ou expiré
  • Vérifiez que vous avez copié le token correctement
  • Vérifiez que le token existe dans Paramètres → Clés API

403 Interdit :

  • Le token n’a pas les permissions requises
  • Vérifiez que vous êtes dans la bonne organisation

Erreurs réseau :

  • Vérifiez votre connexion Internet
  • Vérifiez que l’URL de l’API est correcte : https://us.teamday.ai

Étape 5 : Créer votre premier agent

Créons maintenant un agent IA en utilisant l’API.

Créer un agent via l’API

Demande :

curl -X POST "https://us.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mon premier agent",
    "systemPrompt": "Vous êtes un assistant utile qui peut répondre à des questions et aider avec des tâches. Soyez concis et amical.",
    "model": "claude-sonnet-4-6",
    "visibility": "private"
  }'

Réponse :

{
  "id": "char_abc123xyz",
  "name": "Mon premier agent",
  "systemPrompt": "Vous êtes un assistant utile...",
  "model": "claude-sonnet-4-6",
  "visibility": "private",
  "organizationId": "org_xyz789",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T10:00:00Z"
}

Sauvegardez l’ID de l’agent (char_abc123xyz) - vous en aurez besoin pour exécuter l’agent.

Screenshot

Créer un agent via l’interface utilisateur

Préférez une interface visuelle ?

  1. Naviguer vers “Agents” dans la barre latérale
  2. Cliquez sur ”+ Nouvel agent”
  3. Remplissez les détails :
    • Nom : “Mon premier agent”
    • Modèle : Sélectionnez “Claude 3.5 Sonnet”
    • Invite système : Entrez les instructions ci-dessus
    • Visibilité : Sélectionnez “Privé”
  4. Cliquez sur “Créer un agent”

Screenshot

Testez votre agent

Exécuter via l’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": "Bonjour ! Avec quoi pouvez-vous m'aider ?"
  }'

Réponse :

{
  "executionId": "exec_456def",
  "message": "Bonjour ! Je suis votre assistant utile. Je peux vous aider avec une variété de tâches, notamment répondre à des questions, fournir des informations, aider à l'analyse, et bien plus encore. Avec quoi voulez-vous de l'aide aujourd'hui ?",
  "usage": {
    "inputTokens": 245,
    "outputTokens": 89
  },
  "status": "completed"
}

Screenshot

Exécuter via l’interface utilisateur :

  1. Naviguer vers “Agents” → “Mon premier agent”
  2. Cliquez sur “Discuter”
  3. Tapez votre message : “Bonjour ! Avec quoi pouvez-vous m’aider ?”
  4. Appuyez sur Entrée ou cliquez sur Envoyer
  5. Voyez la réponse de l’agent

Screenshot

Prochaines étapes

Félicitations ! Vous avez réussi à :

  • ✅ Créer votre compte TeamDay
  • ✅ Configurer votre organisation
  • ✅ Générer un token d’accès personnel
  • ✅ Faire votre premier appel API
  • ✅ Créer et tester votre premier agent IA

Prochaines étapes recommandées

1. Créer un agent plus spécialisé

2. Configurer un espace de travail

3. Se connecter à GitHub

  • Permettez à votre agent de travailler avec vos référentiels
  • Guide : Intégration Git

4. Installer des plugins MCP

  • Étendez les capacités de votre agent avec des outils et des intégrations
  • Guide : Plugins MCP

5. Explorez l’API

  • En savoir plus sur les fonctionnalités avancées de l’API
  • Référence : Documentation API

Ressources d’apprentissage

Obtenir de l’aide

Communauté :

Support :

Partagez votre expérience

Nous aimerions connaître votre première expérience avec TeamDay !

  • Partagez sur Twitter : @teamdayai
  • Laissez des commentaires : feedback at teamday.ai

Bon développement ! 🚀