Ejecuciones de agentes y atribución
Cuando un agente de IA cambia de trabajo en Kanera, el registro lo dice. Sus comentarios, cambios de tarjetas y filas de actividades están etiquetados con el nombre del agente y la persona para la que actuó, para que nadie confunda la salida del agente con algo que escribió un compañero de equipo. Mientras un agente está trabajando una tarjeta, puede abrir una ejecución: un marcador vivo en la ficha de la tarjeta que le indica al resto del equipo que el trabajo ya se está realizando.
Cómo se atribuye el trabajo del agente
Kanera registra quién realizó una acción según la credencial detrás de ella.
| Conexión | Cómo aparece su trabajo |
|---|---|
| OAuth, incluido el código del dispositivo | Como la persona que conectó al agente, con un a través de <agente> insignia. El nombre del agente es el nombre con el que se registró el cliente de IA, como Claude. |
| Clave API personal | Como propietario de la clave, sin etiqueta de agente. Un script que ejecuta con su propia clave lee como usted. |
| Agente desatendido o Clave API del espacio de trabajo/tablero | Bajo la conexión o nombre clave, no como persona. |
La distinción es la concesión interactiva de OAuth, no el transporte. el Kanera CLI admite ambos: inicio de sesión en el navegador con kanera auth login --agent "Claude Code" las etiquetas funcionan a través del agente, mientras que el inicio de sesión con clave API lo registra como el propietario de la clave o la clave. Ver Trabajar con agentes de codificación desde la terminal. para ver cómo eso afecta el flujo de trabajo de una terminal.
La insignia vía
En el feed de actividad de una tarjeta, un comentario escrito por un agente mantiene el nombre y el avatar de la persona y agrega un a través de <agente> insignia al lado. Pase el cursor sobre la insignia para ver quién escribió el comentario y para quién, por ejemplo. Escrito por Claude en nombre de Amelia Hart. Los cambios de tarjeta que realiza un agente llevan la misma placa, con un Hecho por… en nombre de… información sobre herramientas.
El trabajo de agente sigue estando sujeto al rol de la persona conectada. Kanera verifica su acceso actual en el tablero de destino para cada escritura, por lo que un agente no puede hacer nada que su persona no pueda hacer.
El agente se ejecuta
Una ejecución es la sesión de trabajo de un agente en una tarjeta. Así es como un agente anuncia "Estoy en esto" antes de comenzar el trabajo de varios pasos y cómo informa el progreso y el resultado.
Iniciar una carrera
Un agente inicia una ejecución con el runs.start Herramienta MCP, que proporciona la tarjeta, un título breve para el trabajo y, opcionalmente, una nota de progreso más larga y un enlace donde una persona puede seguirlo, como una solicitud de extracción o un registro de sesión. Desde un caparazón, la misma herramienta es kanera run start <card> "<title>", con kanera run update y kanera run done para informar y terminar. Las integraciones pueden utilizar POST /api/v1/cards/{cardId}/agent-runs en el API pública.
Para iniciar o actualizar una ejecución se necesita acceso al editor en el tablero de la tarjeta y una credencial con capacidad de escritura. Una clave de solo lectura o un observador no pueden abrir una ejecución.
Antes de comenzar, un agente debe llamar runs.list para comprobar si otro agente ya está trabajando en la tarjeta, reanudar su propia ejecución en vivo para la misma tarea o informar el conflicto de ejecución en vivo de otro agente antes de realizar trabajos superpuestos. Devuelve ejecuciones en vivo de forma predeterminada o el historial completo de ejecuciones de la tarjeta con includeEnded.
El chip en la ficha de la tarjeta.
Mientras una carrera está activa, el mosaico de la tarjeta muestra un pequeño chip brillante antes del título. Pase el cursor sobre él o léalo con un lector de pantalla para ver el agente y el trabajo:
- Trabajando: <agente> está trabajando: <título>
- Esperando a una persona: <agente> te está esperando: <título>, y el chip se vuelve ámbar.
Si hay más de una ejecución activa en la tarjeta, la etiqueta nombra la primera y agrega (+N más). El chip se actualiza en tiempo real para todos los que ven el tablero y desaparece cuando finaliza la ejecución.
Ejecutar estados
| Estado | Establecido por | lo que significa |
|---|---|---|
running | el agente | Trabajando. Cada carrera comienza aquí. |
blocked | el agente | Esperar a una persona, como una pregunta o una aprobación. El chip se vuelve ámbar y se muestran los detalles de la tarjeta. esperando por ti. |
succeeded | el agente | Terminado. Termina la carrera. |
failed | el agente | No se pudo completar el trabajo. Termina la carrera. |
cancelled | el agente | Se detuvo deliberadamente. Termina la carrera. |
stalled | Kanera | El agente dejó de informar. |
running y blocked están en vivo y muestran el chip. El agente se mueve entre ellos e informa del progreso, con runs.update, manteniendo el resumen en una línea sobre lo que está haciendo ahora. succeeded, failed, y cancelled finalizar la ejecución de forma permanente: una ejecución finalizada no se puede cambiar y se rechaza una actualización adicional.
Establecer una ejecución para blocked cambia el chip. No envía a nadie una notificación por sí solo. Si el agente necesita una persona concreta, también deberá dejar un comentario en la tarjeta diciendo a qué está esperando.
Carreras estancadas
cada runs.update La llamada cuenta como un latido, incluido uno que no cambia nada. Kanera comprueba si hay ejecuciones silenciosas cada minuto y marca una ejecución en vivo stalled una vez que hayan pasado quince minutos sin latir. el runs.update La herramienta les dice a los agentes que informen al menos cada diez minutos.
Una ejecución detenida ya no muestra el chip ni aparece en la tarjeta El agente se ejecuta sección, por lo que un agente bloqueado no puede dejar una tarjeta como si estuviera ocupada. La fuente de actividad de la tarjeta la registra como Kanera marcando la carrera del agente como detenida. Sin embargo, una ejecución estancada no se cierra: el agente puede regresar y finalizarla con un estado de terminal, o configurarla en running para reanudar.
La plantilla de flujo de trabajo del agente
Si entrega la mayor parte del trabajo de un tablero a los agentes, inicie el espacio de trabajo desde el Flujo de trabajo del agente plantilla. Sus listas siguen la vida de una carrera, por lo que el propio tablero muestra lo que están haciendo los agentes:
| Lista | lo que contiene |
|---|---|
| Trabajo pendiente | Obra lista para entregar a un agente. |
| Agente trabajando | Un agente tiene un running ejecutar en la tarjeta. |
| esperándome | El agente fijó su ejecución en blocked y necesita una decisión tuya. El resumen de ejecución dice lo que necesita. |
| Revisión | El trabajo está listo para su revisión. Verifique el resultado, a menudo una solicitud de extracción en el Solicitud de extracción campo. |
| hecho | Aceptaste el trabajo. Kanera marca la tarjeta como completa. |
Las carreras nunca mueven ni completan cartas por sí solas. Los agentes registran la lista original antes de mover una tarjeta, luego vuelven a leer la tarjeta y el tablero antes de la entrega. Consideran la lista original, las listas actualmente disponibles y sus significados, el trabajo completado y el trabajo restante, y eligen la lista que refleja el estado real de la tarjeta en el flujo de trabajo de ese tablero. Volver a la lista original puede ser apropiado, pero no es automático. Los nombres y el orden de la lista no prescriben un destino. Si la elección no está clara, dejan la lista sin cambios, guardan otras actualizaciones de seguimiento y preguntan.
Una ejecución exitosa puede cubrir sólo una parte de una tarjeta. Los agentes completan la tarjeta sólo cuando el flujo de trabajo acordado lo permite y se cumplen sus criterios; esta plantilla tiene como valor predeterminado la aceptación humana. Antes de su respuesta final, publican un comentario de resultado con cambios, verificación, enlaces, trabajo restante y el motivo de la ruta, finalizan la ejecución adecuadamente y verifican las actualizaciones guardadas. Las solicitudes exploratorias y de solo lectura no generan escrituras de seguimiento y las restricciones explícitas de usuario tienen prioridad.
La plantilla también agrega Característica, error, tarea, y Investigación etiquetas y una tarjeta de inicio que explica el flujo. El agente del administrador de la organización puede crear el espacio de trabajo para usted con workspaces.create y templateId: "agent-workflow".
Se ejecuta en detalle y actividad de la tarjeta.
Abre una tarjeta con una carrera en vivo y un El agente se ejecuta La sección aparece directamente debajo de la descripción. Cada ejecución muestra su título, el agente, su estado (trabajando o esperando por ti), cuándo informó por última vez y su última nota de progreso.
En esa sección solo aparecen ejecuciones en vivo. Cuando finaliza una ejecución, desaparece y el resultado se convierte en una fila en el feed de actividades de la tarjeta, como terminado: <título> — <resumen de cierre>, o falló o cancelado para los otros finales. El resumen final es la nota que dejó el agente cuando finalizó la ejecución, así que pídales a los agentes que hagan un registro útil de lo que sucedió.
Se registra el inicio de una ejecución, pero la alimentación de la tarjeta no la repite; la sección en vivo es donde se muestra el trabajo a bordo.
Notificaciones sobre el trabajo del agente
Kanera normalmente te deja fuera de las notificaciones sobre tus propias acciones. El trabajo que su agente realizó a través de OAuth es la excepción: se le notifica como lo sería sobre el trabajo de un compañero de equipo en una tarjeta que observa o a la que está asignado, porque delegar el trabajo no es lo mismo que verlo suceder.
Una vez que un agente ha actuado en su nombre, el cajón de notificaciones obtiene una Agente pestaña al lado No leído y Todos. Enumera lo que hicieron sus agentes, las notificaciones no leídas más las leídas en los últimos siete días, y su etiqueta lleva el recuento de no leídos, como Agente (1). Cada notificación lleva el a través de <agente> insignia. Cuando agrupa notificaciones por usuario, el trabajo de su agente forma su propio grupo etiquetado <persona> a través de <agente> en lugar de fusionarse con el tuyo.
El inicio y el final de una carrera se registra en la actividad de la tarjeta, pero nunca envía una notificación. Las notificaciones cubren lo que realmente hizo el agente, como comentarios, movimientos y finalización.
Trabajo del agente en Trabajo Realizado
el Trabajo realizado La vista mantiene la producción de los agentes separada del esfuerzo propio de las personas. Una fila producida por un agente muestra una marca brillante al lado de la persona y su información sobre herramientas dice Trabajado por <persona> a través de <agente>. La pila de avatar del resumen del día lleva la misma marca.
Las filas de agentes no se cuentan como trabajo propio de la persona. El filtrado del trabajo realizado por un miembro muestra solo las acciones de esa persona, por lo que la entrega de una semana nunca cuenta silenciosamente la producción de un agente como las horas de alguien.
Encontrar actividad del agente
- Notificaciones: el Agente La pestaña es la cola de revisión de todo lo que hicieron sus agentes.
- Una tarjeta: El feed de actividad de la tarjeta muestra a través de <agente> insignias y carreras finalizadas. Un agente puede leer el historial de ejecución completo con
runs.listyincludeEnded. - Integraciones: ganchos web entregar
agentRun:startedyagentRun:updatedeventos para automatizaciones que reaccionan al trabajo de los agentes.
No existe un filtro en todo el tablero para la actividad de los agentes en el feed de actividades o en el Trabajo realizado.