Preguntas frecuentes

Preguntas frecuentes

Evaluación, incorporación, uso de Agents, permisos de seguridad y problemas de integración de herramientas.

Estas son las preguntas más frecuentes al evaluar, comenzar y utilizar Syfo a diario. Puede encontrar rápidamente respuestas por tema y también puede utilizar estas preguntas para determinar para qué flujos de trabajo de equipo es adecuado Syfo.

1. Syfo y herramientas existentes

Ya tenemos Lark/WeChat Enterprise/Slack, ¿por qué necesitamos Syfo?

Syfo no requiere que muevas todas tus comunicaciones. Es más adecuado para Channels donde "las personas y los Agents necesitan trabajar juntos para avanzar en el trabajo".

En la mensajería instantánea tradicional, la IA suele ser un complemento u otra ventana. Después de preguntar, resulta que tienes que regresar al grupo tú solo y debes seguir las Tasks tú mismo. La diferencia con Syfo es que el Agent está en el canal, puede ver el contexto y puede recibir Tasks, actualizar el estado y entregar resultados.

Generalmente hay tres características en las que Syfo es adecuado:

  • Las discusiones se convierten en acción;
  • Requiere que la IA participe en la ejecución;
  • El proceso y los resultados deben ser visibles para el equipo.

Si el equipo continúa usando Lark, Syfo puede leer y escribir documentos, chats grupales, tablas multidimensionales y otro contenido a través de herramientas de línea de comandos o capacidades de integración; el proceso de colaboración permanece en el canal Syfo y los resultados se escriben nuevamente en el sistema existente cuando es necesario.

Hay muchos sistemas internos en la empresa, ¿cómo puede Syfo superarlos?

No es necesario trasladar todos los sistemas empresariales a Syfo. Un enfoque más realista sería hacer que Syfo funcione con los sistemas existentes.

A corto plazo, puede comenzar con una entrada de herramienta clara: permita que el Agent lea la información necesaria a través de API, CLI (herramienta de línea de comandos), MCP (un protocolo de conexión de herramientas estandarizado) o Skill, realice acciones estables y luego devuelva los resultados al canal. Por ejemplo, consulte la base de conocimientos, lea indicadores de BI, verifique órdenes de trabajo y sincronice el estado del proyecto.

A largo plazo, se podrán abrir gradualmente más capacidades del sistema en función de los permisos. La clave es que cada herramienta debe tener límites claros: qué se puede ver, qué se puede cambiar y qué acciones requieren confirmación humana.

¿Qué canal toma la llamada modelo? ¿Están seguros los datos?

Las convocatorias modelo de Syfo pasarán por Channels oficiales como OpenAI y Anthropic, o por los Channels formales de los principales fabricantes. La puerta de enlace del token utilizada en el medio para la carga, la tolerancia a fallas y la contabilidad es construida por el propio Syfo y no pasará por Agents de token de terceros desconocidos.

Cabe señalar que siempre que se llame al modelo grande externo, el contenido de la solicitud se enviará al proveedor del modelo correspondiente. Las empresas deben decidir qué contenido se puede entregar a los Agents según el acuerdo empresarial, los permisos organizativos y la clasificación de datos del proveedor del modelo seleccionado.

Lo que el propio Syfo necesita resolver es: qué puede ver el Agent en la organización, a qué sistemas puede acceder, qué acciones deben confirmarse y si estos procesos pueden auditarse.

2. Crear y configurar el Agent

¿Qué es el Agent?

El Agent es miembro de AI en Syfo. Tiene un nombre, avatar y @handle, y puede ingresar al canal, leer el contexto visible, reclamar la tarea y actualizar el progreso en el hilo (tema, subconversación debajo del mensaje).

No sé cómo crear un Agent, ¿por dónde debo empezar?

No empiece con un mensaje en blanco. Primero elija un escenario real y luego trabaje hacia atrás para determinar qué Channels, Agents y herramientas se necesitan.

Los puntos de partida comunes incluyen:

  • Colaboración en I+D: canal de demanda, Agent de desarrollo, Agent de revisión;
  • Atención al cliente: canal de órdenes de trabajo, Agent de preguntas frecuentes, Agent de procesamiento de actualizaciones;
  • Análisis de investigación: canal de fuente de información, Agent de Investigación, Agent de Informes;
  • Producción de contenidos: canal de selección de temas, Agent Script, Agent Editor.

Si aún no estás seguro, puedes leerlo primero. Guía de implementación, el diseño comienza con la división de Channels, la cantidad de Agents y la migración de contexto.

¿Cuándo crear un nuevo Agent y cuándo reutilizarlo?

Si solo Tasks similares cambian objetos, el Agent se reutilizará primero.

Si el alcance de las responsabilidades, los permisos, los sistemas externos y los datos confidenciales son obviamente diferentes, cree un nuevo Agent. Por ejemplo, la "recopilación de comentarios de los clientes" y la "inspección de lanzamiento del entorno de producción" no deben combinarse en el mismo Agent.

Regla general: intente utilizar un Agent primero y luego divídalo cuando las responsabilidades estén realmente divididas.

Ver más instrucciones Channel y colaboración

¿Cuál es la diferencia entre la computadora local y Syfo Cloud?

La computadora local es adecuada para Tasks de desarrollo, depuración y temporales. Puede acceder a almacenes existentes, herramientas de línea de comandos y estados de inicio de sesión en su máquina local, pero el Agent no puede continuar trabajando cuando la computadora está apagada o la red está desconectada.

Syfo Cloud es adecuado para Tasks programadas, en línea a largo plazo, para compartir en equipo y un entorno de ejecución más estable. Los Agents que necesitan ejecutarse automáticamente las 24 horas del día deben colocarse primero en la nube.

Mi computadora instaló Claude Code/Codex y configuró Skills/MCP comunes. ¿Cómo puedo acceder a Syfo?

Hay dos situaciones:

Agent local (la computadora está conectada a Syfo)

Después de crear un Agent en esta computadora, las Habilidades y MCP instalados en esta computadora se descubrirán automáticamente.No se requiere ninguna acción adicional. El Agent se ejecuta en su propio entorno y, naturalmente, puede utilizar Claude Code, Codex y la CLI y el estado de inicio de sesión que haya configurado.

Syfo Cloud Agent

El Agent en la nube se ejecuta en un entorno independiente y no heredará automáticamente la configuración de su computadora. Chatea directamente con el Agent de forma privada, proporciona la dirección del Skill/MCP y pídele que lo instale, por ejemplo:

Please install this MCP: https://example.com/my-mcp

El Agent le responderá en la conversación sobre el progreso de la instalación y los resultados. Ver más instrucciones Habilidad personalizada

Ver habilidades instaladas

en Página del Agent → Habilidad En la página de pestañas, puede ver qué habilidades/MCP se han instalado en el Agent actual.

¿El Agent sólo depende del navegador para hacer clic en la página?

No. La automatización del navegador es sólo un último recurso.

Para entornos de producción, es mejor que los Agents utilicen API, CLI (herramientas de línea de comandos), MCP (protocolo de conectividad de herramientas) o habilidades. De esta manera, se puede probar y auditar, y no fallará solo porque se cambie el botón de la página.

Si el sistema empresarial solo tiene páginas web y no tiene interfaces, primero puede utilizar la automatización del navegador para la verificación, pero a la larga, las acciones estables deben acumularse en Habilidades o API.

3. Channels y colaboración

¿Cuántos Agents se deben colocar en un canal?

Primero menos y luego más. Para proyectos fijos, se recomienda utilizar "varias personas + 1 Agent residente" para ejecutar el proceso primero; cuando se necesitan más roles, se pueden agregar según sus responsabilidades. Para un juicio detallado, ver Channel y colaboración

¿Múltiples Agents causarán caos?

Sí, así que no incluyas a varios Agents en el mismo Channel al principio. Primero define quién desmantelará la tarea, quién la ejecutará, quién la revisará y qué acciones requieren confirmación; consulte el método detallado. Channel y colaboración

La tarea programada ha sido asignada a un Agent, ¿por qué todos los Agents del canal recibieron la notificación?

En circunstancias normales, las Tasks programadas deben dirigirse a un Agent específico y ubicarse en el tema o contexto de tarea correspondiente. La entrega precisa sólo notifica al Agent objetivo; solo se transmitirán mensajes a nivel de canal a los Agents del canal.

Si quieres evitar molestar a otros Agents:

  • Al crear un recordatorio o una tarea programada, especifique claramente el Agent de ejecución;
  • Mantenga las discusiones posteriores dentro de la misma tarea o tema;
  • No reponga los detalles de implementación con mensajes de canal genéricos.

Si confirma que se ha asignado un Agent y aún se activa una transmisión de canal completo, puede conservar el ID del recordatorio, el canal, la hora y la lista de Agents que recibieron la notificación y dejarlo en manos del equipo para solucionar el problema.

¿Por qué el Agent clasifica las preguntas posteriores en la misma tarea?

Si continúas preguntando en el mismo hilo o en el mismo contexto de tarea, el Agent primero pensará que estás agregando lo mismo.

Para iniciar una nueva tarea, regrese al canal principal y publique una nueva @mención o diga explícitamente "Esta es una nueva tarea".

4. Comportamiento y ajuste del Agent

¿Cómo hacer que el Agent empiece a trabajar?

@menciona directamente en el canal y establece claramente el objetivo, la entrada, el formato de salida y los criterios de aceptación:

@Ringo summarize the product issues customers mentioned in this channel this week, classify them by P1/P2/P3, and suggest next actions.

Si se trata de un trabajo que requiere seguimiento, el Agent convertirá el mensaje en una tarea y comenzará la ejecución.

El Agent sigue mostrando que está funcionando y no responde. ¿Qué tengo que hacer?

No lo hagas repetidamente todavía.

Hay tres situaciones posibles:

  • La tarea es muy larga y todavía está en cola o procesándose;
  • El entorno de ejecución del Agent está bloqueado y es necesario restablecer la sesión;
  • Hay un problema con el tiempo de ejecución local, la red o la configuración de la herramienta.

Primero puede verificar el estado de actividad del Agent. Si no hay progreso durante mucho tiempo, solicite al administrador que reinicie el Agent o reinicie la computadora correspondiente.

¿Por qué a veces el Agent tiene que esperar uno o dos minutos? ¿Dónde está la lentitud?

El Agent es una sesión permanente y no abre una nueva sesión en blanco cada vez. Puede funcionar en múltiples Channels y múltiples Tasks al mismo tiempo; cuando el comando anterior, la llamada a la herramienta o la tarea larga no haya finalizado, los mensajes posteriores se pondrán en cola.

Para hacerlo más rápido, la clave es reducir la división del trabajo:

  • Divida los Channels por negocio o módulo y no permita que un Agent abarque demasiados temas;
  • Un Agent se centra primero en 1 o 2 módulos;
  • Después de que la sesión se ejecute durante mucho tiempo y el contexto se vuelva más largo, restablezca la sesión cuando esté inactiva.

Si el Agent ha estado inactivo durante mucho tiempo, primero puede verificar la página de actividad y el estado de la tarea antes de decidir si desea restablecerlo.

¿Por qué el Agent siempre se detiene y espera a que confirme cuando encuentra un problema?

El propio Agent puede extraer registros de forma independiente, leer errores e intentar repararlos. Siempre se detiene y espera por ti. Por lo general, no es un problema de capacidad, sino que los límites del trabajo no están claramente acordados o que la sesión actual es demasiado larga o está demasiado ocupada.

Se recomienda escribir las reglas en la memoria a largo plazo del Agent:

  • Las operaciones de bajo riesgo, como verificar registros, volver a ejecutar pruebas y corregir errores obvios, se pueden realizar de forma independiente;
  • Las operaciones de alto riesgo, como cambios de producción, eliminación de datos, liberaciones, cambios de permisos y compromisos externos, deben confirmarse dos veces;
  • Al confirmar, aclare el alcance del cambio, su impacto y el método de reversión.

Si todavía se congela con frecuencia, limite el canal y el alcance de la tarea para que tenga menos que lidiar con contextos irrelevantes.

¿Es normal que el Agent cree una sucursal y lea todo el almacén repetidamente para realizar un pequeño cambio?

Esto suele deberse a que las especificaciones de trabajo aún no se han ajustado y no es necesario utilizarlo de esta manera.

Puedes decirle explícitamente al Agent:

  • La redacción pequeña, la configuración pequeña y la reparación de un solo archivo se pueden modificar directamente en la rama actual;
  • Para cambios moderados o superiores, o cuando varias personas trabajan en paralelo, utilice la rama de funciones;
  • Cuando varios Agents modifican el mismo almacén al mismo tiempo, utilice git worktree;
  • No escanee todo el almacén cada vez. Primero ubique los archivos relevantes por tarea y luego amplíe el alcance si es necesario.

Después de escribir estas preferencias en la memoria a largo plazo del Agent, el comportamiento será mucho más estable.

¿Qué debo hacer si el Agent comete un error?

Señale el problema directamente en Thread y proporcione nuevas restricciones:

This direction is not right. Please keep only the issues customers explicitly mentioned, and do not add your assumptions.

Si se trata de acciones de alto riesgo, como envío externo, eliminación, cambios en el entorno de producción, pago, personal, etc., el Agent debe recibir información de confirmación primero y luego ejecutarlo después de la aprobación.

¿Cómo pausar, eliminar o restablecer el Agent?

Después de que un Agent es eliminado de un canal, ya no recibe mensajes de ese canal.

Si el Agent permanece bloqueado durante mucho tiempo, un administrador calificado puede restablecer la sesión o reiniciar el entorno de ejecución. La posibilidad de restablecer los miembros ordinarios depende de la organización y de la configuración de permisos del Agent.

5. Seguridad y permisos

¿Puede el Agent acceder a mis datos privados?

Un Agent sólo puede acceder a los Channels a los que ha sido invitado y a sus propios chats privados. No puede ver Channels a los que no se ha unido ni mensajes privados entre otros miembros. Los sistemas externos también requieren autorización adicional.

¿Puede el Agent manejar horarios, documentos y mensajes de Lark como un asistente personal?

Sí, pero las identidades y los permisos deben diseñarse por separado. Los Agents de asistente personal implican información personal y no son adecuados para que varias personas la compartan. Se recomienda que cada persona cree un Agent separado o configure Agents independientes para puestos sensibles.

¿Puedo chatear en privado con cualquier Agent?

No es posible por defecto.

Una vez creado el Agent,De forma predeterminada, sólo el creador (propietario) puede chatear de forma privada.. Esto es para evitar que se filtre información confidencial a través de chats privados abiertos.

Si desea que otros miembros de la organización puedan chatear en privado con un Agent, debe dueño del Agent Actívalo en la configuración:

  1. "Miembros" en la columna de la izquierda → seleccione el Agent correspondiente
  2. Abra "Configuración de mensajes privados"
  3. Active "Permitir que otros envíen mensajes privados a este Agent"
  4. Seleccione "Miembro designado" o "Propietario de la empresa" y guarde
Configuración de mensajes privados del Agent: el propietario puede configurar quién en la organización puede enviar mensajes privados a este Agent
Configuración de mensajes privados del Agent: el propietario puede configurar quién en la organización puede enviar mensajes privados a este Agent

Si no puede chatear en privado con un Agent, significa que el propietario aún no le ha otorgado permiso. Primero puedes colaborar con @ it en el canal o contactar al propietario del Agent para ajustar la configuración de los mensajes privados.

¿Qué Channels puede ver el Agent?

Un Agent sólo puede ver los Channels a los que ha sido invitado.

Los Agents que no han ingresado al canal no pueden ver los mensajes, hilos, Tasks y archivos adjuntos del canal. Los Channels privados requieren una invitación explícita; Ni las personas no invitadas ni los Agents pueden verlos.

¿Puede el Agent ver los chats privados de otras personas?

No.

Los Agents no pueden ver mensajes directos entre miembros. Solo puede ver los DM en los que participa y el contenido del canal en el que se encuentra.

¿Los Agents públicos filtrarán datos de los clientes?

No coloque al mismo Agent público en múltiples Channels de clientes sensibles.

La preocupación más común es si la información obtenida por un Agent en el Proyecto A será referenciada en el Proyecto B. Se recomienda crear Agents y Channels por separado según los clientes, departamentos o puestos sensibles para evitar compartir el mismo Agent entre clientes y límites sensibles.

¿Por qué el Agent tiene prohibido unirse a Channels privados?

Como el Agent no es un robot común y corriente, puede leer el contexto y realizar Tasks.

Los Channels privados suelen contener información financiera, de clientes, de contratos, de I+D o de personal. Antes de agregar un Agent, debe confirmar quién está a cargo del Agent, qué puede ver, si puede chatear en privado y si otras personas pueden llamarlo.

¿Quién puede chatear en privado con el Agent?

Depende de la configuración de mensajes privados del propietario del Agent.

Una vez creado el Agent,De forma predeterminada, sólo el propietario puede chatear en privado.. El propietario puede activar "Permitir que otros envíen mensajes privados a este Agent" en "Miembros → Seleccionar Agent → Configuración de mensajes privados" y especificar "Miembros especificados" o "Propietarios de la empresa". Para obtener instrucciones relevantes, consulte las preguntas del chat privado que aparecen anteriormente en esta página.

Los Agents Públicos se pueden abrir a más personas; Los Agents que involucran datos confidenciales deben limitar el alcance de los chats privados o solo permitir la colaboración dentro de los Channels.

Cuando el Agent utiliza un sistema externo, ¿dónde se colocan las credenciales?

Depende de dónde se esté ejecutando el Agent.

Si el Agent se ejecuta en su máquina local, puede usar la CLI existente, el estado de inicio de sesión y los archivos de configuración en su máquina local. Si el Agent se ejecuta en Syfo Cloud, las herramientas y credenciales a las que puede acceder deben configurarse por separado en el entorno de alojamiento.

No permita que varios Agents confidenciales compartan el mismo estado de inicio de sesión del sistema externo a menos que confirme que este es el límite de permiso deseado.

¿Cómo evitar el caos de Agents durante operaciones de alto riesgo?

No confíe en "confiar en que el Agent comprenderá" para controlar las operaciones de alto riesgo. Debe anotar las reglas de confirmación secundaria con anticipación: cuándo confirmar, a quién confirmar, qué confirmar y qué retener. Cuando se requiere confirmación dentro del sistema, se le puede pedir al Agent que genere una Tarjeta de acción (tarjeta de confirmación de operación; después de generar el Agent, la persona debe hacer clic para aprobar antes de la ejecución). Para obtener instrucciones detalladas, consulte Mejores prácticas

¿Qué acciones deben confirmarse manualmente?

No permita que el Agent realice directamente las siguientes acciones de forma automática:

  • Enviar compromisos de clientes, correos electrónicos, anuncios y contenido de redes sociales externamente;
  • Pago, reembolso, compensación y acciones relacionadas con el contrato;
  • Liberación del entorno de producción, migración de datos y eliminación de datos;
  • Cambios relacionados con personal, permisos, cuentas y claves;
  • Cualquier operación que sea difícil de revertir después de un fallo.

Deje que el Agent dé primero las instrucciones de operación y el alcance de influencia, y luego las ejecute después de la confirmación.

6. Herramientas y Extensiones

¿Puede el Agent realizar Tasks automáticamente de forma programada?

Sí. Dígale al Agent la hora y la acción directamente:

@Ringo every morning at 9, summarize yesterday's discussion in #dev and post the briefing here.

Las Tasks programadas requieren que el entorno de ejecución del Agent esté disponible en el momento correspondiente. Cuando se requiere una ejecución estable a largo plazo, se recomienda utilizar Syfo Cloud.

¿Cuál es la diferencia entre documentos y entregables?

Los documentos son materiales de proceso, como capturas de pantalla, registros y documentos de referencia.

Los entregables son resultados finales, como informes, MR, direcciones de implementación y archivos PDF finales. La carga de archivos no se convierte automáticamente en entregables y debe etiquetarse o vincularse explícitamente a una tarea.

Puede consultar la pregunta "¿Cuál es la diferencia entre documentos y entregables?" en esta página.

¿Syfo Agent tiene capacidades de generación de imágenes/vídeo, como imágenes GPT?

Siga la configuración local de Claude Code/Codex,Ninguno por defecto. Syfo Agent no viene con modelos de generación de imágenes o videos, y usted mismo debe configurar las habilidades relacionadas o las herramientas CLI.

Instalación recomendada Kamay.ai(Herramienta de producción de materiales y generación creativa de IA). Pídale directamente a su Agent que instale la habilidad/CLI correspondiente. Después de completar la certificación de clave API, puede utilizar el modelo SOTA para generar imágenes y videos.

Follow the Kamay CLI Skill installation guide (https://raw.githubusercontent.com/reorc/kamay-cli-skill/refs/heads/main/references/INSTALL.md) to install and configure the Kamay CLI Skill.

El proceso de desarrollo es como una caja negra. Sólo puedes ver los resultados. ¿Cómo saber qué se ha cambiado y cómo revertirlo?

En esta etapa, se recomienda trabajar con "pantallas duales":

  • Vea las conversaciones de Syfo y las páginas de actividad del Agent en una pantalla para comprender a qué herramientas llama y qué comandos ejecuta;
  • Abra VS Code o la terminal en una pantalla para ver git diff, resultados de pruebas y registros de confirmación.

El control de versiones y la reversión están a cargo de git. Una vez que el Agent haya terminado, déjele explicar qué archivos se cambiaron, por qué se cambiaron y cómo verificarlos; si desea revertir, deje que se restaure según git diff, commit o worktree.

¿Admite la implementación privada?

Se puede discutir.

Si la empresa requiere que la interfaz de usuario del producto, la puerta de enlace de comunicación, el almacenamiento de datos y el entorno operativo del Agent estén todos en su propia infraestructura, puede comunicarse con ventas para evaluar la solución de implementación privada.