Documentos de la guía
Switcher y orquestación
Qué es Switcher
Switcher es una forma de trabajar con agentes de programación mediante una pantalla de conversación en lugar de una terminal. El plan, la ejecución de herramientas, los archivos modificados, las solicitudes de aprobación y el uso se ven juntos dentro de la conversación.
Los motores con los que se pueden abrir conversaciones de Switcher son Claude Code, Codex, Antigravity (agy), OpenCode y GitHub Copilot CLI. Claude Code, Codex y Antigravity llevan la etiqueta 추천 (Recomendado). Las funciones admitidas (deshacer, objetivos, adjuntos, entrada durante la respuesta, etc.) varían según el motor, y para las que no se admiten se muestra el motivo.
Iniciar una nueva conversación
- En el rail izquierdo, abra el menú
⋯de la fila del proyecto. - En 새 세션 (Nueva sesión), elija una herramienta.
- Las herramientas compatibles tienen por separado una sesión de CLI y una sesión de Switcher. Si elige Switcher, se crea una nueva conversación en este proyecto con el motor de esa herramienta.
Una nueva conversación empieza con los valores predeterminados de la carpeta. Si la carpeta no tiene valores, se usa el predeterminado global. Los valores predeterminados se definen en «Valores predeterminados para nuevas conversaciones de Switcher» de Conexiones y configuración por proyecto.
Funciones dentro de la conversación
Cambiar el modelo y el esfuerzo de razonamiento
Encima del cuadro de entrada se eligen el modelo y el esfuerzo de razonamiento (effort). En la lista de modelos puede buscar o introducir el ID directamente. El valor cambiado se aplica a partir del siguiente mensaje. No se puede cambiar mientras se procesa una respuesta o una aprobación.
El esfuerzo de razonamiento solo se puede elegir dentro del rango que se ha confirmado que admiten el modelo elegido y la herramienta de ejecución. Si no se ha confirmado la compatibilidad, se envía con el valor predeterminado de la herramienta y se deja un aviso.
Cambiar la herramienta de ejecución
Puede cambiar la herramienta de ejecución de una misma conversación por otra. La sesión y sus relaciones se mantienen y, si es necesario, el contexto se transfiere mediante la compactación y el resumen de trabajo de la herramienta original. Si el cambio falla o no hay espacio suficiente para transferirlo, la sesión existente se deja como estaba.
En 대화 모델 바꾸기 (Cambiar el modelo de la conversación) del teléfono se elige en el orden proveedor → herramienta → modelo. El proveedor elegido solo se aplica a esta conversación y no cambia la configuración del proyecto.
Menú de comandos
En la conversación, abra el menú de comandos con Ctrl+/. Puede ejecutar /help, /new, /stop, /model, /status, /search, /copy, /export, /retry y /clear. Los comandos que no se pueden ejecutar en ese momento se muestran junto con el motivo.
Información de la conversación
Al abrir 대화 정보 (Información de la conversación) en la cabecera, se ven en un solo lugar el entorno, el uso del contexto, la rama, las tareas pendientes, los archivos modificados y su diff, los subagentes y las tareas en segundo plano.
Continuar una conversación
Al volver a abrir la aplicación, se restauran la lista de conversaciones de Switcher y la disposición del trabajo. En la conversación que quiera continuar, pulse 재연결 (Reconectar) para seguir con la misma conversación. Leer la lista no ejecuta ninguna CLI.
Revisión de código con IA
En ⋯ Más → AI 코드리뷰 (Revisión de código con IA) de Switcher se revisan los cambios antes de hacer commit. Los cambios solo se envían a una conexión cuando elige una conexión con clave de API guardada y un modelo, y pulsa 리뷰 실행 (Ejecutar revisión). Abrir o actualizar la pantalla no llama al modelo.
Conversación por voz
Si activa 환경 설정 › 음성 대화 (Preferencias › Conversación por voz) y elige una conexión de API de OpenAI, puede hablar con la sesión actual mediante 음성 대화 (Conversación por voz) en la cabecera de Switcher. Está desactivada de forma predeterminada. La voz se envía directamente a OpenAI con la clave de API de OpenAI del usuario y se factura a esa clave. Detener el trabajo y las aprobaciones solo se ejecutan tras confirmarlos en pantalla.
Orquestación
La orquestación es una función en la que una conversación de Switcher (la sesión coordinadora) crea otras sesiones (workers) y les asigna trabajo. Los workers pueden informar de resultados o hacer preguntas a la sesión coordinadora.
Designar una sesión coordinadora
- Abra la conversación de Switcher que va a coordinar.
- Pulse 오케스트레이션 세션으로 지정 (Designar como sesión de orquestación).
- En 오케스트레이션 권한 선택 (Elegir permisos de orquestación), elija el modo.
- 사용자 승인 후 위임 (Delegar tras la aprobación del usuario): el usuario confirma antes de ejecutarlas las delegaciones, como crear workers o darles instrucciones.
- 전체 자율 위임 승인 (Aprobar la delegación totalmente autónoma): las entradas delegadas explícitamente se entregan sin aprobación adicional.
La elección, la aprobación y la revocación de permisos solo se pueden hacer desde la pantalla del usuario. Las reglas de aprobación del motor existente y las restricciones de la carpeta de trabajo se mantienen. La política se guarda cifrada en este PC.
Workers y tareas
- La sesión coordinadora crea workers en los proyectos registrados o reanuda sesiones anteriores como workers. Al crearlos puede definir el modelo y el esfuerzo de razonamiento.
- Los workers creados aparecen como una fila bajo el proyecto en el rail y se abren como pestañas de Switcher en segundo plano que no roban el foco.
- Si un worker está ocupado, las instrucciones y respuestas enviadas se guardan en una cola y se entregan en orden.
- La sesión coordinadora registra las solicitudes del usuario como 지휘 할 일 (Tareas de la coordinación) y las vincula a las tareas de los workers. El progreso que informa el worker y la finalización que la coordinación confirma tras revisar el resultado se muestran por separado.
Panel y diagrama de relaciones
Al abrir 오케스트레이션 대시보드 (Panel de orquestación) en la sesión coordinadora, verá el diagrama de relaciones entre coordinación, líderes de equipo y workers, el estado de las tareas y entregas, y el registro de decisiones. El estado de entrega solo se muestra hasta la etapa realmente confirmada, como «승인 대기» (Esperando aprobación), «전달 중» (Entregando), «입력 접수 · 완료 미확인» (Entrada recibida · finalización sin confirmar), «실행 여부 불명» (Ejecución desconocida) o «완료» (Completado). Las solicitudes cuya ejecución se desconoce no se reenvían automáticamente.
En la PWA y la aplicación de Android también puede consultar y manejar el panel de orquestación y las tareas pendientes.
Permiso de líder de equipo
La sesión coordinadora puede dar el permiso de líder de equipo a un worker directo. El líder de equipo gestiona sus propios workers subordinados dentro de los proyectos asignados y del límite de ejecuciones simultáneas. Aunque se revoque el permiso, las conversaciones y ejecuciones subordinadas se mantienen.
Delegar en otro PC
También puede crear workers en otro PC de la misma cuenta que haya conectado mediante 내 컴퓨터 (Mis equipos) en el rail. El PC receptor también debe definir sus permisos de orquestación.
- Si el PC receptor está en 위임마다 승인 (Aprobar cada delegación), debe aprobarse en ese PC para que se ejecute. Si no responde antes del plazo, se rechaza.
- Si el PC receptor está en 자율 위임 (Delegación autónoma), se ejecuta de inmediato.
Una misma solicitud solo se ejecuta una vez. Aunque se pierda la respuesta, la llegada se comprueba con el registro de ese PC. El otro PC también debe tener la misma versión o una posterior.
Reglas de limpieza
- 종료 (Detener) solo detiene los procesos que inició Switchboard y conserva la conversación, la información para reanudar y las relaciones.
- Los workers inactivos terminan su proceso tras 15 minutos de forma predeterminada. Los workers que informaron su resultado y se detuvieron automáticamente se mueven al archivo tras 60 minutos de forma predeterminada.
- Las tareas que esperan aprobación, una pregunta o una confirmación se excluyen de la limpieza automática.
- 탭 닫기 (Cerrar pestaña) no termina la sesión. Si la restaura desde el archivo, puede volver a reanudarla.
En el modo supervisado (delegar tras la aprobación del usuario), esta limpieza también requiere la aprobación del usuario.