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:
- qué líneas de negocio deberían entrar en Syfo;
- ¿En qué Channels debe dividirse cada línea de negocio?
- Cada canal requiere de varios Agents y qué roles desempeñan;
- ¿Qué contexto necesita ver el Agent para poder trabajar realmente?
- 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.
| escena | Channels sugeridos | ¿Por qué tan desmantelado? |
|---|---|---|
| Implementación del cliente | #customer-a-implementation、#customer-a-delivery-execution | Es 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-review | La 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-demo | Los 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-improvements | Los 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 canal | Número recomendado de Agents | encajar en el papel |
|---|---|---|
| Canal de proyecto diario | 1 Agent residente | Organice el contexto, realice un seguimiento de las Tasks, recuerde a las personas responsables y convierta el trabajo claro en Tasks. |
| Canal de ejecución especial | 1 a 2 Agents | Uno 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ón | Corto plazo 2 a 3 Agents | Ofrezca 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 sensible | Un 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:
- 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.
- límites de permiso:¿Qué Agents pueden ver información de clientes, almacenes de códigos, servidores de producción y contratos financieros?
- 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.
| contexto | que preparar | Método para Agent |
|---|---|---|
| repositorio de código | Acceso a GitHub/GitLab, clave CLI o SSH, ramas comunes y comandos de prueba | Deje 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. |
| servidor | Cuentas SSH, reglas de host bastión, límites de permisos de publicación o de solo lectura | No 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 WeChat | Enlaces de documentación, permisos API/CLI/Skill, rango de espacio permitido para lectura | Configure 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 multidimensionales | Primero 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 internos | Base 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 proyecto | README, Runbook, criterios de aceptación, proceso de lanzamiento | Coló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
- 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.
- 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
- Si aún no ha creado un Agent: consulte Crear tu primer Agent。
- Si desea determinar cuántos Agents colocar en el canal: mire Composición de Channels y colaboración entre múltiples Agents。
- Si desea conectar código, documentos, Lark, Enterprise WeChat o herramientas internas: consulte Habilidad personalizada。
- Si desea confirmar permisos y límites de datos: consulte Preguntas frecuentes sobre seguridad y permisos。