Prácticas de equipo

Incorpora Syfo al trabajo diario de tu equipo

Un enfoque de diseño de Channels, Agents y contexto que abarca desde pruebas individuales hasta colaboración en equipo.

Cuando el equipo se está preparando para presentar oficialmente Syfo, el primer paso no es crear un Agent, sino descubrir cómo dividir el canal, cómo dividir el trabajo del Agent y dónde colocar el contexto. Esta guía le ayuda a completar esta planificación.

Lo que realmente hay que pensar primero no es "crear algunos Agents", sino:

  1. qué líneas de negocio deberían entrar en Syfo;
  2. ¿En qué Channels debe dividirse cada línea de negocio?
  3. Cada canal requiere de varios Agents y qué roles desempeñan;
  4. ¿Qué contexto necesita ver el Agent para poder trabajar realmente?
  5. Qué normas de colaboración deben respetar los miembros del equipo.

Primero separa los Channels por línea de negocio

Los Channels son sitios de trabajo dentro de Syfo. Debe existir un canal en torno al mismo contexto, el mismo conjunto de participantes y el mismo conjunto de Tasks.

No copie la estructura organizacional primero y no abarrote todo #general. Primero, enumere las líneas de negocio que ejecuta el equipo actual y luego determine cuáles requieren Channels independientes.

escenaChannels sugeridos¿Por qué tan desmantelado?
Implementación del cliente#customer-a-implementation#customer-a-delivery-executionEs necesario centralizar la información del cliente, el progreso de la entrega y el seguimiento de los problemas; Los detalles de implementación se pueden dividir desde Channels de discusión hasta Channels dedicados.
I+D interno#product-planning#dev-runtime#release-reviewLa discusión del producto, la implementación del código y la inspección en línea requieren diferentes participantes y diferentes permisos de Agent.
Seguimiento de ventas#sales-leads#enterprise-demoLos clientes potenciales, los antecedentes de los clientes y los materiales de presentación deben recopilarse continuamente para evitar que se dispersen en chats privados.
comentarios de los clientes#customer-feedback#faq-improvementsLos comentarios originales y la documentación/mejoras del producto pueden estar relacionados, pero no es necesario mezclarlos en el mismo hilo.

Al dividir Channels, dé prioridad a cuatro dimensiones:

  • proyecto o cliente: Proyectos, clientes y líneas de entrega a largo plazo, adecuados para Channels independientes.
  • sensibilidad: No publique contratos, cotizaciones, entorno de producción, privacidad del cliente, personal interno y otra información en el canal público.
  • Fase de ejecución: La discusión de requisitos, la revisión del plan, la entrega de la ejecución y la revisión en línea se pueden separar para evitar que un canal sea demasiado largo y ruidoso.
  • rol de participación: Si algo requiere sólo unas pocas personas y unos pocos Agents durante mucho tiempo, no lo pongas en el canal para todos los miembros.

Un proyecto puede corresponder a un canal o a varios Channels. Los criterios de juicio son simples: si el mismo grupo de personas, el mismo grupo de Agents y el mismo conjunto de permisos pueden manejarlo, colóquelo primero en un canal; Si el contexto, los permisos o el ritmo de ejecución son obviamente diferentes, divídalos.

Decide cuántos Agents poner en cada Channel

Cuantos más Agents, mejor. Con cada Agent adicional en el canal, más Agents pueden leer el mismo mensaje, lo que hace que la discusión sea más probable que se vuelva ruidosa.

Primero utilice el siguiente método de juicio:

tipo de canalNúmero recomendado de Agentsencajar en el papel
Canal de proyecto diario1 Agent residenteOrganice el contexto, realice un seguimiento de las Tasks, recuerde a las personas responsables y convierta el trabajo claro en Tasks.
Canal de ejecución especial1 a 2 AgentsUno es responsable de la ejecución y el otro es responsable de la revisión o aceptación; las responsabilidades deben ser diferentes.
Planificar ataque y defensa / investigación y discusiónCorto plazo 2 a 3 AgentsOfrezca sugerencias desde diferentes perspectivas, como usuarios, productos de la competencia, ingeniería y datos, y saque conclusiones después de la conclusión.
Canal comercial sensibleUn pequeño número de Agents independientes.Configure de forma independiente según los permisos y no lo mezcle con otros clientes, departamentos o entornos de producción.

Al diseñar el rol de Agent, primero haga tres preguntas:

  1. Requisitos de concurrencia: ¿Qué Tasks se deben ejecutar al mismo tiempo? Si solo se ejecuta de forma secuencial, basta con que un Agent lo complete paso a paso.
  2. límites de permiso:¿Qué Agents pueden ver información de clientes, almacenes de códigos, servidores de producción y contratos financieros?
  3. Límites de responsabilidad: ¿Se repetirá la salida de los dos Agents? Si hay duplicados, primero combine las responsabilidades.

Generalmente se deben volver a verificar los Channels con más de 3 Agents durante mucho tiempo:

  • Si existen responsabilidades superpuestas;
  • ¿Debería dividirse en Channels dedicados?
  • Si los datos con diferentes permisos se colocan en el mismo Channel;
  • ¿Se añaden Agents sólo para "parecer más fuertes"?

Para un juicio más detallado, consulte Composición de Channels y colaboración entre múltiples Agents y Mecanismo de entrega de mensajes del Agent

Mueve el contexto a un lugar visible para el Agent

Que el Agent pueda hacer un buen trabajo depende no sólo del modelo, sino también de lo que puede ver y qué herramientas puede utilizar.

El contexto del canal, las Tasks, los archivos y los entregables en Syfo se depositarán naturalmente en el Agent del canal. Sin embargo, aún es necesario acceder a los sistemas externos con anticipación: bibliotecas de códigos, servidores, documentos Lark, registros corporativos de WeChat, bases de datos, BI, backend interno, etc. deben ser accesibles para el entorno operativo donde se encuentra el Agent.

contextoque prepararMétodo para Agent
repositorio de códigoAcceso a GitHub/GitLab, clave CLI o SSH, ramas comunes y comandos de pruebaDeje que el Agent de I+D se ejecute en una computadora o entorno de nube con permisos de almacén configurados y fije la entrada del almacén, la sucursal y la prueba en la parte superior del canal.
servidorCuentas SSH, reglas de host bastión, límites de permisos de publicación o de solo lecturaNo publique claves privadas en el canal; configure las credenciales en un entorno operativo controlado y deje que el Agent explique los comandos a ejecutar y el alcance del impacto.
Documentos de Lark/Enterprise WeChatEnlaces de documentación, permisos API/CLI/Skill, rango de espacio permitido para lecturaConfigure la CLI o Skill correspondiente para el Agent de documentos y envíe enlaces de documentos clave al canal o tarea.
Registros de comunicación con el cliente.Exportación de chat grupal, CRM, sistema de órdenes de trabajo, formularios multidimensionalesPrimero defina el calibre de desensibilización y la estructura del campo, y luego deje que el Agent los organice incrementalmente. No mueva todo el texto original al canal sin filtrar.
datos internosBase de datos, BI, informes, calibre de indicadores.Dar prioridad a los permisos de solo lectura; Deje que el Agent genere el calibre de la consulta y el resumen de resultados, y las escrituras de alto riesgo deben confirmarse manualmente.
Reglas del proyectoREADME, Runbook, criterios de aceptación, proceso de lanzamientoColóquelo en la parte superior del canal, descripción de la tarea o documento del almacén para garantizar que los nuevos miembros y Agents puedan ver el mismo conjunto de reglas.

Varios principios:

  • El contexto se sitúa donde ocurre el trabajo.: Los datos del proyecto se colocan en el canal del proyecto, la información del cliente se coloca en el canal del cliente y los detalles de ejecución se colocan en el hilo de la tarea.
  • Las credenciales no ingresan a los mensajes ordinarios.: No envíe claves, tokens y claves privadas SSH directamente al canal; colóquelos en el entorno de ejecución del Agent o en la configuración controlada.
  • Los permisos se otorgan según las responsabilidades del Agent.: Comentarios de los clientes El Agent no requiere permisos del servidor de producción; Release Check Agent no requiere registros de chat privados del cliente.
  • Deje que el Agent explique primero los límites de las capacidades: Después de conectarse nuevamente a un sistema externo, permita que el Agent informe a qué puede acceder, a qué no puede acceder y cómo verificarlo.

Cuando necesite conectar herramientas externas, puede consultar Habilidad personalizada. Si se trata de datos confidenciales, mire de nuevo Preguntas frecuentes sobre seguridad y permisos

Acordar las reglas de uso del equipo

El buen uso de Syfo o no depende de si el equipo ha desarrollado hábitos de colaboración consistentes. Se recomienda fijar una especificación corta en la parte superior del canal central. Una versión es suficiente por primera vez y los ajustes posteriores deben realizarse en función de los problemas reales.

buen hábito

  • Una necesidad, una entrada: Lo mismo solo se avanza en un canal o en un hilo de tarea.
  • Pon información clave en el mismo hilo.: Los antecedentes, la información, las discusiones, las decisiones y los resultados de aceptación no deben estar dispersos en varios lugares.
  • Explique claramente lo que se requiere y los criterios de aceptación.: No se limite a decir "Ayúdame a ver", diga objetivos, limitaciones, formatos de salida y lo que se considera un buen trabajo.
  • Los asuntos urgentes van precedidos de "urgentes": Tanto las personas como los Agents deben identificar rápidamente las fallas en línea, la congestión de clientes y los riesgos de entrega.
  • Utilice Tasks para realizar la ejecución.: El trabajo que necesita seguimiento se convierte en una Tarea, con propietario, estado y siguiente acción.
  • Permitir que el Agent actualice el progreso en el hilo: El canal principal conserva las conclusiones clave y los detalles del proceso convergen en Tasks o subprocesos.

malos hábitos

  • Un requisito es un grupo de Agents al mismo tiempo, lo que permite que varios Agents lean el contexto y la salida repetidamente.
  • Publicar lo mismo repetidamente en múltiples Channels lleva a conclusiones bifurcadas y nadie sabe dónde está la última.
  • Sólo se dan instrucciones vagas y no se dan antecedentes, información ni criterios de aceptación.
  • Permitir que el Agent realice directamente operaciones irreversibles como eliminación, publicación, pago y compromisos externos.
  • El resultado del Agent se considera completo a menos que alguien lo acepte.
  • Combine información confidencial de clientes, entorno de producción y gestión interna en Channels públicos.

Dos reglas de hierro

  1. Las operaciones sensibles o irreversibles deben ser confirmadas por la presencia humana.

Para la eliminación, el pago, los cambios de producción, los compromisos del cliente, la entrega externa y los cambios de permisos, el Agent debe explicar primero el contenido de la operación, el alcance del impacto y el método de reversión, y luego ser confirmado por la responsable.

  1. Para la convergencia se priorizan las fallas en línea y los bloqueos de clientes.

Comience con "Urgente" y describa el alcance del impacto, el estado actual, la persona responsable y los resultados esperados; no se expanda en múltiples Channels al mismo tiempo.

Una norma de equipo que se puede copiar directamente.

# Syfo Team Usage Guidelines

1. Keep one source of truth per request: choose a channel message, task, or Thread as the main line.
2. Turn executable work into a Task, and keep the owner, status, and next action clear.
3. When you @Agent, state the context, goal, materials, priority, output format, and acceptance criteria.
4. Keep key information in the same thread. Do not repeat the same request across multiple channels.
5. Start urgent items with “Urgent”, and state the impact scope and expected result.
6. Sensitive or irreversible actions must be confirmed by a human before execution.
7. Agent output must be reviewed by a person; without review, it is not done.

Siguiente paso