Gestionar agentes

TeeckIn admite dos tipos de agentes, según tu flujo de trabajo:

Dónde gestionas los agentes depende del tipo:

• -Agentes personales: Configuración > Agentes (en el contexto personal)
• -Agentes de organización: Configuración de la organización > Agentes

Puedes crear agentes de forma manual en TeeckIn o automáticamente durante el flujo de OAuth (para herramientas como Claude Code que admiten la autenticación en el navegador).

Creación manual (interfaz)

1. 1Haz clic en Añadir agente
2. 2Selecciona el tipo de agente (Claude Code, Cursor, etc.)
3. 3Ponle un nombre descriptivo (p. ej., «Claude del MacBook de Jordan»)
4. 4Opcionalmente, añade una descripción
5. 5Haz clic en Crear

Creación automática (OAuth en el navegador)

Al usar Claude Code u otras herramientas que admiten OAuth en el navegador, puedes crear un nuevo agente directamente en el flujo de autorización, sin necesidad de visitar antes la configuración de TeeckIn.

La pantalla de autorización muestra todos tus agentes disponibles, agrupados por contexto:

• -Personal: tus agentes personales + la opción de crear uno nuevo
• -Organizaciones: cada organización a la que perteneces con sus agentes + la opción de crear uno nuevo

Esto te permite elegir dónde registrar el tiempo (en tu cuenta personal o en una organización concreta) directamente durante el flujo de OAuth.

Para las herramientas que necesitan autenticación con credenciales de cliente, cada agente puede tener hasta . Tener varios secretos resulta útil para:

• -Rotación de secretos sin interrupciones
• -Distintas máquinas (portátil del trabajo, equipo de casa)
• -Entornos de CI/CD con secretos separados

Crear secretos adicionales

1. Haz clic en la tarjeta del agente para desplegarla
2. Ve a la pestaña Secretos
3. Haz clic en Nuevo secreto
4. Opcionalmente, añade una etiqueta (p. ej., «Servidor de producción»)
5. Copia el nuevo secreto de inmediato: no se volverá a mostrar

Eliminar secretos

Para eliminar un secreto, búscalo en la pestaña Secretos y haz clic en Eliminar. El secreto deja de funcionar de inmediato. Debes conservar al menos un secreto.

Haz clic en el botón de editar de la tarjeta de un agente para cambiar su nombre o descripción. El tipo de agente no se puede cambiar tras la creación.

Cuando eliminas un agente:

• -Todos los secretos se invalidan de inmediato
• +Las entradas de tiempo se conservan con toda su atribución
• -El agente se marca como inactivo y se oculta de las listas
• +Los agentes inactivos no cuentan para los límites del plan

Las entradas de tiempo mostrarán el nombre del agente con una insignia «(Inactivo)» en las vistas históricas.

Cada tarjeta de agente muestra:

• -Última actividad: cuándo hizo el agente su última llamada a la API
• -Número de secretos: cuántos secretos activos existen

Cada secreto muestra cuándo se usó por última vez, lo que te ayuda a identificar y limpiar las credenciales sin usar.

Registro de actividad

Despliega la tarjeta de un agente y haz clic en la pestaña Registro de actividad para ver un historial detallado de las acciones del agente. Esto incluye:

• -Eventos de inicio/parada del cronómetro
• -Actualizaciones de entradas de tiempo
• -Intentos de autenticación
• -Direcciones IP (para la supervisión de seguridad)

Los propietarios y administradores pueden configurar los ajustes de agentes a nivel de organización desde la página de configuración de Agentes:

• -Orientación para la selección de temas: ayuda a los agentes a entender cómo elegir el tema adecuado según el trabajo que realizan
• -Tarifa por hora predeterminada del agente: establece una tarifa predeterminada para las horas de los agentes cuando se incluyen en las facturas
• -Incluir horas de agente en las facturas: controla si las horas de los agentes se incluyen de forma predeterminada al crear facturas

De forma predeterminada, las horas de agente no se incluyen en las facturas. Al crear una factura, puedes optar por:

• -Excluir por completo las horas de agente (predeterminado)
• -Incluirlas a la tarifa de agente predeterminada de la organización
• -Incluirlas a una tarifa personalizada para esta factura

Cada entrada de tiempo creada por un agente se etiqueta automáticamente con la identidad del agente. Esta atribución te ayuda a:

• -Hacer seguimiento del trabajo asistido por IA: saber con exactitud qué entradas crearon los agentes frente a las personas
• -Cumplir con la auditoría: mantener registros claros de la participación de la IA en tu trabajo
• -Tomar decisiones de facturación: identificar fácilmente las horas de agente al preparar las facturas

El nombre del agente aparece en las entradas de tiempo en el calendario, el historial del cronómetro y las pantallas de facturación. Incluso si después se elimina un agente, la atribución se conserva mostrando «Agente eliminado» en los registros históricos.

Cuando exportas tus datos, los agentes se incluyen por exactitud histórica:

• -Metadatos del agente: se exportan el nombre, el tipo y la configuración
• -Atribución de las entradas de tiempo: se conserva qué agente creó cada entrada
• -Secretos: no se exportan (seguridad)

Al importar

Los agentes se importan como inactivos, ya que los secretos no se pueden transferir. Esto garantiza que:

• +La atribución histórica se conserve con precisión
• +Los registros de auditoría permanezcan intactos
• -Los agentes importados no puedan autenticarse hasta reactivarse

La vista de calendario incluye opciones de filtrado para separar el trabajo de las personas y el de los agentes:

• -Todos: muestra todas las entradas de tiempo, tanto de personas como de agentes
• -Personas: muestra solo las entradas de los miembros humanos del equipo
• -Agentes: muestra solo las entradas de los agentes de IA

Accede a estos filtros haciendo clic en el icono de filtro de la barra de herramientas del calendario. También puedes combinarlos con los filtros de miembro y de grupo.