Trabajar con Agentes

Cómo funciona el trabajo en equipo de Agente

Con Team Mode desactivado, Alex gestiona la solicitud. Activa Team Mode cuando el trabajo necesite que Mike coordine varias etapas o cuando quieras mencionar a un Product Manager, Architect, Data Analyst u otro especialista disponible.

En Modo Equipo, el trabajo puede pasar de un Agente a otro. Sigue Working Process y los mensajes del Agente hasta que no haya trabajo activo. Si el resultado crea una tarjeta de Versión, selecciona Preview para abrirla en el Visor de Apps y probarla antes de publicar o solicitar otro cambio.

Activar o desactivar Modo Equipo

El interruptor de Team Mode está en el menú + junto al campo de entrada del Chat. Cuando el interruptor está desactivado, Alex gestiona la solicitud. Cuando está activado, Chat puede usar a Mike y a los Agentes especialistas disponibles.

Antes de cambiar: No puedes cambiar Modo Equipo mientras Investigación profunda o Nube de Atoms estén activos. Investigación profunda usa solo a Iris, por lo que la lista normal de Group Members no está disponible. Usa los Agentes que se muestran en el Chat actual. Si Modo Equipo está fijado como activado y se muestra Alex, menciona a Alex directamente para una tarea de ingeniería. Para usar las opciones estándar de Modo Equipo, sal del flujo de trabajo dedicado y abre un Chat normal del proyecto.

1. Abre el Chat del proyecto.
2. Selecciona + junto al cuadro de mensaje.
3. En el menú, activa Team Mode para el flujo de trabajo del equipo. Desactívalo cuando quieras que Alex gestione la solicitud.
4. Cierra el menú, escribe la solicitud y envíala.

Si escribes @ mientras Modo Equipo está desactivado, Chat muestra Switch to team mode to mention Agent. Selecciona Team para activar Modo Equipo y abrir Group Members, o selecciona Engineer para cerrar el selector y seguir trabajando con Alex sin una mención.

Activar o desactivar Modo Equipo

Deja que Mike coordine el trabajo

Cuando Team Mode está activado y Mike está disponible en Group Members, envía un mensaje sin una mención con @ cuando quieras que Mike decida qué Agentes deben encargarse del trabajo. Esta es la opción más simple para un resultado que abarca varias etapas. Si Investigación profunda está activa, usa Iris en su lugar.

1. Asegúrate de que Mike esté disponible. Activa Team Mode cuando el interruptor esté disponible. Si el interruptor está bloqueado, usa este flujo de trabajo solo cuando Mike aparezca en Group Members.
2. Describe el resultado final, el estado actual del proyecto, los límites importantes y cómo evaluarás el resultado.
3. Envía la solicitud sin una mención con @ para que Mike pueda coordinarla. Para dirigirte a él explícitamente, escribe @ y selecciona Mike en Group Members.
4. Sigue Working Process y los mensajes del Agente. Responde una pregunta cuando aparezca. Si una tarjeta de Plan está lista, selecciona Approve para continuar o abre su menú de flecha y selecciona Decline cuando el plan necesite revisión.

Este tipo de solicitud le da a Mike suficiente información para planificar el trabajo sin requerir que asignes cada paso tú mismo.

Menciona a un Agente directamente

Menciona a un Agente cuando sepas quién debe recibir una tarea enfocada.

1. En un proyecto normal, selecciona + junto al campo de entrada del Chat y activa Team Mode. Si un flujo de trabajo dedicado bloquea el modo, omite este paso y usa solo los Agentes que se muestran en el Chat actual.
2. Escribe @ en el cuadro de mensaje.
3. En Group Members, selecciona el Agente.
4. Después de la mención, explica la tarea, el contexto importante, qué debe permanecer sin cambios y el resultado que esperas.
5. Envía el mensaje.

Selecciona un Agente de Group Members

Group Members normalmente incluye a Alex, Bob, David, Emma y Mike. Sarah y Adrian aparecen en proyectos compatibles de shadcn/ui o Nube de Atoms. Cuando Investigación profunda está habilitada, el selector de menciones muestra solo a Iris. Usa la lista que se muestra en tu Chat como fuente de verdad.

Agent	Role	Use this Agent when
Mike	Líder de equipo	La tarea necesita planificación, delegación o coordinación entre varios Agentes.
Emma	Product Manager	Necesitas aclarar usuarios, prioridades, alcance, flujos de trabajo o compensaciones entre funcionalidades.
Bob	Architect	Necesitas ayuda con la estructura del sistema, modelos de datos, integraciones o restricciones técnicas.
Alex	Engineer	Quieres crear, cambiar, corregir o probar la implementación del proyecto.
David	Data Analyst	Quieres analizar datos, archivos, métricas o tendencias.
Iris	Investigadora de Investigación profunda	Necesitas investigación técnica, de mercado, competencia o audiencia basada en evidencia.
Sarah	Especialista SEO	Quieres planificar y mejorar contenido SEO para un proyecto web compatible.
Adrian	Especialista en Ads	Quieres preparar o analizar Google Ads para un proyecto web publicado y compatible.

No puedes mencionar a un Agente que no se muestre en Group Members. Pídele a Mike que coordine con el equipo disponible, o usa el flujo de trabajo dedicado que habilita al especialista que necesitas.

Trabaja con más de un Agente

Puedes mencionar a más de un Agente en el mismo mensaje de Team Mode. Usa esto para tareas independientes que no puedan sobrescribirse entre sí, y especifica claramente qué parte debe gestionar cada Agente.

Separa claramente cada asignación e indica si el Agente puede cambiar el proyecto o si solo debe revisarlo.

Para trabajo dependiente, no envíes todas las etapas a varios Agentes a la vez. Pídele a Mike que coordine el orden e incluye el punto en el que debes aprobar el trabajo.

Usa solo los Agentes necesarios para el resultado y luego revisa Credits used después de que el trabajo se complete.

Sigue tareas, aprobaciones y transferencias

Sigue el trabajo en el Chat del proyecto. Working Process muestra los pasos activos del Agente, las tarjetas de preguntas esperan tus respuestas, las tarjetas de Plan esperan aprobación y aparece una tarjeta de Versión cuando el proyecto produce una versión que puedes previsualizar.

What you see	What it means	What to do
Working Processshows an Agent as active	El paso actual sigue en ejecución.	Espera el resultado. Si Queue está habilitado, puedes escribir la siguiente instrucción y presionar Return para ponerla en cola sin detener el trabajo activo.
Una tarjeta de pregunta	Mike necesita información antes de que el flujo de trabajo pueda continuar.	Responde cada pregunta, usaNextcuando haya otra página y luego seleccionaSubmit.
Una tarjeta de Plan	El plan propuesto está listo para revisión y la ejecución no ha comenzado.	SeleccionaApprovepara continuar. Para solicitar una revisión, abre la flecha junto a Approve y seleccionaDecline.
La respuesta final de un Agente	Ese Agente ha terminado el paso asignado.	RevisaWorking Processy los mensajes posteriores antes de considerar que toda la solicitud está completa.
Otro Agente empieza a trabajar	El trabajo se ha transferido a otro especialista.	Sigue los mensajes del nuevo Agente y responde si solicita información o aprobación.
Una tarjeta de Versión	El proyecto produjo una versión que puede revisarse.	Para la versión más reciente, seleccionaPreview. Para una versión histórica, selecciona primeroLoad previewy luegoView Preview.

Una respuesta escrita, un Plan o un resumen de investigación no confirman por sí solos que el proyecto haya cambiado. Cuando la solicitud incluye implementación, busca la tarjeta de Versión resultante, selecciona Preview y prueba el recorrido completo del usuario en el Visor de Apps.

Envía un seguimiento útil

Un seguimiento útil le dice al Agente qué cambió, qué debe seguir igual y cómo comprobar el resultado.

Mientras un Agente está trabajando, escribe la siguiente instrucción en el campo de entrada del Chat. Cuando el campo diga Press Return to queue the message, presiona Return. El mensaje se agrega al panel Queue encima del campo de entrada y espera sin interrumpir el trabajo activo.

El panel Queue aparece automáticamente después de que se pone en cola el primer mensaje. Expándelo si está contraído. Arrastra los mensajes para reordenarlos; usa Send now, Edit o Remove en un mensaje individual. Un mensaje en cola con un archivo adjunto no puede editarse. El encabezado de Queue también ofrece Clear queue, Pause processing queued messages y Resume processing queued messages.

Si Queue no está disponible, espera a que la tarea actual termine antes de enviar el seguimiento. No envíes la misma instrucción repetidamente, porque las solicitudes duplicadas pueden crear trabajo en conflicto.

Revisa un seguimiento en cola

Recupérate cuando el trabajo esté atascado o vaya en la dirección equivocada

Empieza con el paso 1 y avanza por la lista solo si el paso anterior no resuelve el problema.

1. Comprueba el estado actual. Lee los mensajes más recientes del Agente y Working Process. Busca un Agente que siga activo, una pregunta o Plan esperando tu respuesta, o un seguimiento esperando en Queue.
2. Corrige la dirección. Envía una sola corrección clara. Describe el resultado previsto, el cambio más pequeño necesario y qué debe permanecer sin cambios. Menciona al Agente que debe encargarse cuando sea necesario.
3. Detén el trabajo activo solo cuando sea necesario. Selecciona el control cuadrado Stop a la derecha del campo de entrada del Chat. Su tooltip dice Click if you want to stop all tasks. En la confirmación, selecciona Yes, I'm Sure. Esto detiene cada tarea activa en ese Chat, y la respuesta interrumpida se marca como Response stopped.
4. Restaura una versión conocida como buena. Si un cambio completado empeoró el proyecto, selecciona Versions en el encabezado del proyecto. Elige la última versión conocida como buena. Si es necesario, selecciona Load preview y luego View Preview. En la vista previa de la versión, selecciona Restore to this version. Antes de confirmar:
   • Si aparece Sync database, revísalo cuidadosamente. Está seleccionado de forma predeterminada. Déjalo seleccionado si quieres restaurar la base de datos con la versión; desmárcalo si quieres conservar la base de datos actual.
   • Selecciona Restore para confirmar. El proyecto vuelve a la versión seleccionada. Las versiones posteriores siguen disponibles en Versions y pueden volver a aplicarse si es necesario.
5. Reporta un problema con Atoms. Si Atoms en sí no se comporta como se espera, abre ... en el mensaje relevante más reciente del Agente y selecciona Feedback. El ID del chat actual y el ID del mensaje se adjuntan automáticamente. Describe los pasos exactos, qué esperabas, qué ocurrió en su lugar e incluye una captura de pantalla clara cuando sea útil.

Antes de detener o restaurar. No uses ninguna de las dos acciones solo porque una tarea esté tardando más de lo esperado. Detener puede descartar el progreso activo. Restaurar cambia el estado actual del proyecto y también puede cambiar la base de datos cuando Sync database está seleccionado.

Detener todas las tareas activas

Revisa el resultado, Créditos e información sensible

Antes de publicar, actualizar o confiar en el resultado, comprueba que:

• Cada etapa solicitada esté completa, incluida cualquier transferencia a otro Agente.
• La versión final se abra correctamente en el Visor de Apps.
• El recorrido principal del usuario funcione de principio a fin.
• El Agente haya conservado la información, las funcionalidades y el diseño que le pediste que no cambiara.
• No aparezca información privada, credenciales ni contenido solo interno en el resultado.

Revisa los Créditos usados

En el último mensaje del Agente en un turno completado, abre .... El menú muestra Worked for; muestra Credits used después de que el turno termina y el uso está disponible. Para comprobar el saldo del espacio de trabajo, abre el menú de tu perfil y selecciona Plans en escritorio o Plans and credits en móvil. En el panel Plans and credits, revisa Credits remaining.

Revisa Credits used después de cada turno completado y revisa el plan y el alcance antes de aprobar una gran cantidad de trabajo.

Revisa Worked for y Credits used

No pegues contraseñas, claves de API, tokens de autenticación, datos de pago ni información personal o confidencial innecesaria en el Chat.

Preguntas frecuentes

¿Qué debo hacer si Atoms rechaza una solicitud porque puede ser dañina?

Atoms puede rechazar una solicitud o pedir aclaraciones cuando el resultado solicitado podría ser inseguro. No intentes ocultar, disfrazar o dividir una solicitud dañina para eludir esa respuesta.

1. Si tu objetivo es legítimo, explica el propósito seguro, quién autorizó el trabajo y qué no debe hacer el resultado.
2. Elimina datos personales reales, credenciales, información confidencial e instrucciones que podrían dañar a otra persona o sistema.
3. Pide una explicación defensiva, una lista de verificación de seguridad o un ejemplo inofensivo en lugar de instrucciones que permitan un uso indebido.
4. Revisa la solicitud revisada antes de enviarla y limítala a la información necesaria para la tarea segura.

Si una solicitud claramente legítima e inofensiva sigue siendo rechazada, contacta con Atoms Support con el Chat Link y una copia redactada de la solicitud. Explica el uso previsto, pero no incluyas información sensible ni pidas a Support que eluda un control de seguridad.