¿Qué hace log_work?
Un agente no necesita buscar IDs antes de registrar. Llama a log_work directamente con una descripción y lo que sepa. Half5 encuentra el cliente, proyecto y actividad, o te pregunta si no lo tiene claro.
La entrada llega como ‘Aún sin aprobar’ a tu nombre. Así tú o quien apruebe mantenéis el control, incluso si el agente ha rellenado el trabajo. Cómo conectar un agente está en Registrar horas con Claude, ChatGPT o Cursor.
¿Qué campos envía el agente?
Solo la descripción es obligatoria. El resto ayuda a Half5 a elegir el cliente y la duración correctos. Sin fecha, Half5 lo registra hoy. Sin duración, Half5 no guarda nada pero te propone una para que la confirmes. Sin cliente, Half5 solo lo asigna si hay un cliente claramente mejor que los demás.
| Campo | Obligatorio | Qué es |
|---|---|---|
description | Sí | Una línea de 3 a 500 caracteres que pueda leer un cliente, en tu idioma, sin nombres de archivos ni clases. Puede acabar en una factura. |
date | No | today, yesterday o una fecha (YYYY-MM-DD). Si no se indica, se usa hoy. |
minutes | No | Duración en minutos, de 1 a 1.440. Se omite si no se sabe la duración. |
start_time, end_time | No | Hora de inicio y fin en formato HH:MM. Si la hora de fin es anterior a la de inicio, el trabajo pasó de medianoche: 21:30 a 01:30 es una entrada de 4 horas en el día de inicio. |
customer, project, activity | No | Nombre, nombre comercial o referencia. Un proyecto también implica su cliente. |
repository | No | Git remote, owner/repo o el nombre de la carpeta. Nunca una ruta local completa. |
branch, commit_subjects | No | La rama y hasta 10 mensajes de commit, como pistas extra para cliente y proyecto. |
session_id | No | El ID de sesión del agente, solo si realmente lo conoce. |
¿Cuáles son los posibles resultados?
Cada llamada termina en uno de estos cuatro estados. Cada uno pide algo distinto al agente.
| Resultado | Qué significa | Qué hace el agente |
|---|---|---|
created | La entrada se guarda, aún sin aprobar. | Te resume en una frase qué se ha registrado y por qué en ese cliente. |
preview | Simulación: esto es lo que se registraría. No se guarda nada. | Te muestra la propuesta. |
needs_confirmation | Half5 no está seguro, por ejemplo sobre el cliente, o falta la duración (‘¿Cuánto tiempo trabajaste en esto?’ con una duración propuesta). | Te hace la pregunta y solo registra tras tu elección, exactamente con la opción que elijas. |
duplicate | Ese trabajo ya está registrado. | No lo registra de nuevo. |
Sin duración, Half5 no guarda nada. La propuesta suele ir, por ejemplo, desde el final de tu última entrada de hoy hasta ahora; tú la confirmas o la ajustas.
¿Cómo elige Half5 el cliente y el proyecto?
Primero el cliente, luego el proyecto dentro de ese cliente. Half5 valora las pistas que tiene y solo registra directamente si hay un cliente claramente mejor. Si no, el agente te pide que elijas entre tus combinaciones recientes de cliente y proyecto.
- Lo que tú indiques. Un cliente o proyecto nombrado manda sobre todo. Si hay dos clientes con el mismo nombre, por ejemplo solo cambiando mayúsculas, gana la coincidencia exacta, luego el cliente en el que ya registraste ese repositorio, y después el que más usas. El agente solo pregunta si nada de eso decide.
- Tu memoria de repositorios. Half5 recuerda por usuario qué repositorio va con qué cliente, aprendido de entradas que confirmaste o moviste.
- El nombre del repositorio. Se compara con los nombres (comerciales), etiquetas y dominios de correo de tus clientes, y con los nombres de proyectos.
- Tu propio historial. Descripciones anteriores que mencionan el repositorio, rama o un número de ticket, y clientes en los que registras últimamente y con frecuencia.
- La descripción, rama y commits. Como pista adicional, no como decisión.
¿Cómo funciona la memoria de repositorios?
La memoria es tuya. Cuando registras a través de un agente, mueves una entrada a otro cliente o registras trabajo de agente en la app de escritorio, Half5 recuerda qué repositorio va con qué cliente. Así la próxima vez el agente no tiene que preguntar.
Si la descripción nombra claramente a otro cliente distinto de tu memoria, Half5 no registra sin más: el agente te pregunta cuál de los dos es. Con la opción de organización ‘Aprender de compañeros’, Half5 también puede sugerir un cliente en el que un compañero haya registrado ese repositorio. Eso es solo una sugerencia; el agente siempre pregunta primero y tu memoria propia manda.
¿Qué herramientas hay además de log_work?
El servidor ofrece seis herramientas. Todas solo funcionan sobre tus propias horas, con los clientes, proyectos y actividades que puedes ver en tu organización.
| Herramienta | Qué hace | Límites |
|---|---|---|
log_work | Registrar trabajo | Las nuevas entradas llegan como aún sin aprobar |
log_work_batch | Hasta 25 entradas en una llamada, por ejemplo una semana entera a posteriori | Cada entrada pasa los mismos controles y preguntas que log_work; una respuesta a una pregunta de cliente compartida vale para todas las entradas que la tengan |
search_customers_projects | Buscar clientes, proyectos y actividades por nombre, nombre comercial, etiqueta o dominio de correo | Solo lectura; no es necesario antes de log_work |
list_entries | Listar tus propias entradas con totales diarios | Solo lectura; hasta 31 días por vez |
update_entry | Cambiar una de tus entradas | Solo entradas aún sin aprobar, y solo si tú lo pides |
delete_entry | Borrar una de tus entradas | Solo entradas aún sin aprobar, tras confirmación |
Una vez aprobada una entrada, el agente ya no puede cambiarla. Eso lo haces tú en Half5.
Así lo hace Half5
En Ajustes → ‘Agentes vinculados’ ves el nombre de cliente de cada conexión, si está verificada, cuándo se usó por última vez y qué puede hacer (ver horas, registrar horas). ‘Desconectar’ revoca su acceso.
En esa misma página tienes tu memoria de repositorios. Puedes borrar un solo enlace con ‘Olvidar …’ o empezar de cero con ‘Olvidar todo’. Qué pasa con estos datos está en Privacidad con agentes de IA. Para proyectos de I+D bajo la WBSO neerlandesa, Half5 no tiene exportación WBSO específica; cómo configurarlo está en Horas WBSO con software.
Preguntas frecuentes
¿El agente tiene que llamar a search_customers_projects antes de registrar?
No. log_work encuentra el cliente y el proyecto por sí mismo. La herramienta de búsqueda es para preguntas como ‘¿qué proyectos tiene este cliente?’ o para nombres ambiguos.
¿Qué pasa si el agente envía la misma entrada dos veces?
Half5 reconoce la entrada y responde duplicate en vez de crear un registro duplicado. El agente no debe volver a registrarla.
¿El agente envía mi código o nombres de archivos?
No debe. El servidor indica expresamente a los agentes que nunca envíen rutas de archivos ni código; la descripción es una línea que pueda leer un cliente, y el repositorio solo se envía como nombre.
¿Puede la memoria de un compañero decidir a qué cliente van mis horas?
No. La memoria de un compañero solo da una sugerencia, y solo si está activado ‘Aprender de compañeros’. El agente entonces te pregunta primero.
¿El agente puede cambiar horas ya aprobadas?
No. update_entry y delete_entry solo funcionan sobre tus propias entradas que aún no están aprobadas. Las horas aprobadas se cambian en Half5.
