TeamDay.ai
← Docs

Comenzando con TeamDay

¡Bienvenido a TeamDay! Esta guía de inicio rápido te pondrá en marcha en aproximadamente 15 minutos. Al final, tendrás:

  • ✅ Una cuenta de TeamDay con autenticación
  • ✅ Tu primer Token de Acceso Personal (PAT)
  • ✅ Realizado tu primera llamada API
  • ✅ Creado tu primer agente de IA

Tabla de Contenidos

Paso 1: Registrarse

Registrarse en TeamDay

Opción A: Registrarse con Google

  1. Visita https://us.teamday.ai
  2. Haz clic en “Registrarse con Google”
  3. Selecciona tu cuenta de Google
  4. Autoriza a TeamDay para acceder a tu perfil

Opción B: Registrarse con GitHub

  1. Visita https://us.teamday.ai
  2. Haz clic en “Registrarse con GitHub”
  3. Autoriza la aplicación TeamDay
  4. Otorga los permisos solicitados

Opción C: Registrarse con Correo Electrónico

  1. Visita https://us.teamday.ai
  2. Haz clic en “Registrarse con Correo Electrónico”
  3. Ingresa tu dirección de correo electrónico
  4. Crea una contraseña segura (mín. 8 caracteres)
  5. Verifica tu dirección de correo electrónico

Screenshot

Completa Tu Perfil

Después de registrarte, se te pedirá que completes tu perfil:

  1. Nombre - Tu nombre completo
  2. Empresa (opcional) - Nombre de tu organización
  3. Puesto (opcional) - Tu título o rol

Haz clic en “Continuar” para proceder.

Screenshot

Paso 2: Crear Tu Organización

Las organizaciones te ayudan a gestionar el acceso del equipo y la facturación.

Configura Tu Organización

  1. Nombre de la Organización - Elige un nombre descriptivo

    • Ejemplo: “Acme Corp”, “Mi Startup”, “Proyectos Personales”

  2. ID de la Organización - Slug auto-generado para acceso API

    • Ejemplo: acme-corp, mi-startup
    • Se puede personalizar (minúsculas, solo guiones)

  3. Plan de Facturación - Comienza en nivel gratuito

    • Gratuito: 100 ejecuciones de agentes/mes
    • Pro: Ejecuciones ilimitadas ($29/mes)
    • Empresa: Precios personalizados

Haz clic en “Crear Organización” para continuar.

Screenshot

Nota: Puedes crear múltiples organizaciones o unirte a las existentes más tarde desde tu configuración.

Paso 3: Crear un Token de Acceso Personal

Los Tokens de Acceso Personal (PAT) te permiten autenticar solicitudes de API y comandos CLI.

  1. Haz clic en tu icono de perfil en la esquina superior derecha
  2. Selecciona “Configuración”
  3. Haz clic en “Claves de API” en la barra lateral izquierda

Screenshot

Crea Tu Primer Token

  1. Haz clic en ”+ Nuevo Token de Acceso Personal”

  2. Configura el token:

    • Nombre: “Token de Inicio Rápido” (o cualquier nombre descriptivo)
    • Expiración: Selecciona “90 días” (recomendado para pruebas)
    • Alcances: Acceso completo (alcances próximamente)

  3. Haz clic en “Crear Token”

Screenshot

Guarda Tu Token de Forma Segura

⚠️ IMPORTANTE: ¡Tu token solo se muestra una vez!

td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Haz esto inmediatamente:

  1. Copia el token a tu portapapeles
  2. Guárdalo de forma segura en un gestor de contraseñas o variable de entorno
  3. Nunca lo confirmes en git o lo compartas públicamente

Guardar en variable de entorno (recomendado):

# macOS/Linux - Añade a ~/.bashrc o ~/.zshrc
export TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

# Windows PowerShell
$env:TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

Recarga tu shell:

source ~/.bashrc  # o source ~/.zshrc

Screenshot

Si pierdes tu token: Debes revocarlo y crear uno nuevo. No hay forma de recuperar un token perdido.

Paso 4: Hacer Tu Primera Llamada API

Verifiquemos que tu token funcione llamando a la API de TeamDay.

Prueba Tu Autenticación

Usando cURL:

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

Respuesta esperada:

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

Deberías ver una lista vacía (ya que no has creado agentes todavía).

Screenshot

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

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

Solución de Problemas de Llamadas API

401 No Autorizado:

  • El token es inválido o ha expirado
  • Verifica que copiaste el token correctamente
  • Comprueba que el token existe en Configuración → Claves de API

403 Prohibido:

  • El token no tiene los permisos requeridos
  • Verifica que estás en la organización correcta

Errores de Red:

  • Verifica tu conexión a Internet
  • Verifica que la URL de API es correcta: https://us.teamday.ai

Paso 5: Crear Tu Primer Agente

Ahora creemos un agente de IA usando la API.

Crear Agente vía API

Solicitud:

curl -X POST "https://us.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Agent",
    "systemPrompt": "You are a helpful assistant that can answer questions and help with tasks. Be concise and friendly.",
    "model": "claude-sonnet-4-6",
    "visibility": "private"
  }'

Respuesta:

{
  "id": "char_abc123xyz",
  "name": "My First Agent",
  "systemPrompt": "You are a helpful assistant...",
  "model": "claude-sonnet-4-6",
  "visibility": "private",
  "organizationId": "org_xyz789",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T10:00:00Z"
}

Guarda el ID del agente (char_abc123xyz) - lo necesitarás para ejecutar el agente.

Screenshot

Crear Agente vía UI

¿Prefieres una interfaz visual?

  1. Navega a “Agentes” en la barra lateral
  2. Haz clic en ”+ Nuevo Agente”
  3. Rellena los detalles:
    • Nombre: “Mi Primer Agente”
    • Modelo: Selecciona “Claude 3.5 Sonnet”
    • Prompt del Sistema: Ingresa las instrucciones anteriores
    • Visibilidad: Selecciona “Privado”
  4. Haz clic en “Crear Agente”

Screenshot

Prueba Tu Agente

Ejecuta vía 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": "Hello! What can you help me with?"
  }'

Respuesta:

{
  "executionId": "exec_456def",
  "message": "Hello! I'm your helpful assistant. I can help you with a variety of tasks including answering questions, providing information, helping with analysis, and more. What would you like assistance with today?",
  "usage": {
    "inputTokens": 245,
    "outputTokens": 89
  },
  "status": "completed"
}

Screenshot

Ejecuta vía UI:

  1. Navega a “Agentes” → “Mi Primer Agente”
  2. Haz clic en “Chat”
  3. Escribe tu mensaje: “Hello! What can you help me with?”
  4. Presiona Enter o haz clic en Enviar
  5. Ve la respuesta del agente

Screenshot

Próximos Pasos

¡Felicidades! Has completado exitosamente:

  • ✅ Creado tu cuenta de TeamDay
  • ✅ Configurado tu organización
  • ✅ Generado un Token de Acceso Personal
  • ✅ Hecho tu primera llamada API
  • ✅ Creado y probado tu primer agente de IA

Próximos Pasos Recomendados

1. Crear un Agente Más Especializado

2. Configurar un Área de Trabajo

3. Conectar a GitHub

4. Instalar Complementos MCP

  • Extiende las capacidades de tu agente con herramientas e integraciones
  • Guía: Complementos MCP

5. Explorar la API

Recursos de Aprendizaje

Obtén Ayuda

Comunidad:

Soporte:

Comparte Tu Experiencia

¡Nos encantaría escuchar sobre tu primera experiencia con TeamDay!

  • Comparte en Twitter: @teamdayai
  • Envía comentarios: feedback at teamday.ai

¡Feliz construcción! 🚀