Agent Switchboard
Descargar

Idioma

Guardamos el idioma que elijas en una cookie.

Tema
Documentos de la guía

Switcher y orquestación

Qué es Switcher

Con Switcher trabajas con tus agentes de programación desde una conversación en lugar de una terminal. El plan del agente, las herramientas que ejecuta, los archivos que cambia, las solicitudes de aprobación y el consumo aparecen juntos en la conversación, así que es fácil seguir lo que está pasando.

Los motores disponibles para Switcher son Claude Code, Codex, Antigravity (agy), OpenCode y GitHub Copilot CLI; Claude Code, Codex y Antigravity llevan la etiqueta 추천 (Recomendado). Funciones como deshacer, los objetivos, los adjuntos o escribir mientras el agente responde dependen del motor. Cuando una no está disponible, la app te dice por qué.

Empezar una conversación

  1. En el rail izquierdo, abre el menú ⋯ de la fila del proyecto.
  2. En 새 세션 (Nueva sesión), elige una herramienta.
  3. Las herramientas compatibles con Switcher ofrecen dos opciones: sesión de CLI y sesión de Switcher. Si eliges Switcher, se abre una conversación nueva en el proyecto con esa herramienta como motor.

Las conversaciones nuevas usan los valores por defecto de la carpeta y, si no los hay, los globales. Cómo fijarlos se explica en «Valores por defecto para conversaciones nuevas en Switcher», dentro de Conexiones y configuración por proyecto.

Dentro de la conversación

Cambiar el modelo y el esfuerzo de razonamiento

El modelo y el esfuerzo de razonamiento (effort) se eligen encima del cuadro de texto. Puedes buscar el modelo en la lista o escribir su ID. El cambio se aplica a partir del siguiente mensaje, y no se puede hacer mientras se procesa una respuesta o una aprobación.

Solo puedes elegir los niveles de esfuerzo de razonamiento que se sabe que admiten el modelo y la herramienta de ejecución. Si no se ha podido confirmar, la petición sale con el valor por defecto de la herramienta y la app te lo indica.

Cambiar la herramienta de ejecución

Puedes seguir la misma conversación con otra herramienta de ejecución. La sesión y sus relaciones se mantienen y, si hace falta, el contexto pasa a la nueva herramienta mediante la compactación y el resumen de trabajo de la anterior. Si el cambio falla o no hay espacio para pasar el contexto, la sesión original queda intacta.

En el teléfono, se hace desde 대화 모델 바꾸기 (Cambiar el modelo de la conversación), eligiendo proveedor → herramienta → modelo. El proveedor elegido solo afecta a esta conversación; la configuración del proyecto no cambia.

Menú de comandos

Pulsa Ctrl+/ durante la conversación para abrir el menú de comandos. Tienes /help, /new, /stop, /model, /status, /search, /copy, /export, /retry y /clear; si alguno no se puede usar en ese momento, verás por qué.

Información de la conversación

대화 정보 (Información de la conversación), en la cabecera, reúne en un solo sitio el entorno, el uso del contexto, la rama, las tareas pendientes, los archivos cambiados con su diff, los subagentes y las tareas en segundo plano.

Retomar una conversación

Al volver a abrir la app recuperas la lista de conversaciones de Switcher y la disposición de la pantalla. Pulsa 재연결 (Reconectar) en la conversación que quieras para seguir donde la dejaste. Cargar la lista no ejecuta ninguna CLI.

Revisión de código con IA

Antes de hacer commit, puedes pedir una revisión de los cambios desde ⋯ Más → AI 코드리뷰 (Revisión de código con IA) en Switcher. Elige una conexión con clave de API guardada y un modelo; los cambios solo se envían a esa conexión cuando pulsas 리뷰 실행 (Ejecutar revisión). Abrir o refrescar la pantalla no llama al modelo.

Conversación por voz

Si activas 환경 설정 › 음성 대화 (Preferencias › Conversación por voz) y eliges una conexión de API de OpenAI, puedes hablar con la sesión actual desde 음성 대화 (Conversación por voz), en la cabecera de Switcher. Viene desactivada. El audio va directamente a OpenAI con tu clave de API de OpenAI, y el coste corre a cargo de esa clave. Detener el trabajo y aprobar acciones siempre requieren una confirmación más en pantalla.

Orquestación

Con la orquestación, una conversación de Switcher pasa a ser la sesión coordinadora (coordinator): crea otras sesiones como sesiones de trabajo (workers) y les encarga tareas. Así repartes un trabajo grande entre varias sesiones y lo sigues desde un solo sitio. Las sesiones de trabajo pueden informar de sus resultados o hacer preguntas a la coordinadora.

Elegir la sesión coordinadora

  1. Abre la conversación de Switcher que va a coordinar.
  2. Pulsa 오케스트레이션 세션으로 지정 (Designar como sesión de orquestación).
  3. En 오케스트레이션 권한 선택 (Elegir permisos de orquestación), elige el modo.
    • 사용자 승인 후 위임 (Delegar tras tu aprobación): confirmas tú antes de que se cree una sesión de trabajo o se le envíe una instrucción.
    • 전체 자율 위임 승인 (Aprobar la delegación totalmente autónoma): lo que se delega explícitamente se entrega sin pedir aprobación aparte.

Elegir, aprobar o revocar permisos solo se puede hacer desde tu pantalla. Las reglas de aprobación del propio motor y los límites de la carpeta de trabajo siguen aplicándose, y la política se guarda cifrada en este PC.

Sesiones de trabajo y tareas

  • La coordinadora crea sesiones de trabajo nuevas en los proyectos registrados o reabre sesiones anteriores como sesiones de trabajo. Al crearlas puede fijar su modelo y su esfuerzo de razonamiento.
  • Cada sesión de trabajo nueva aparece como una fila bajo su proyecto en el rail y se abre en una pestaña de Switcher en segundo plano, para no taparte lo que estás viendo.
  • Si una sesión de trabajo está ocupada, las instrucciones y respuestas que le lleguen esperan en cola y se entregan en orden.
  • La coordinadora anota tus peticiones como 지휘 할 일 (Tareas de la coordinación) y las vincula a las tareas de las sesiones de trabajo. El avance que reporta cada sesión de trabajo y la finalización que la coordinadora confirma tras revisar el resultado se muestran por separado.

Panel y diagrama de relaciones

Desde la sesión coordinadora, abre 오케스트레이션 대시보드 (Panel de orquestación) para ver el diagrama de coordinadora, líderes de equipo y sesiones de trabajo, el estado de las tareas y las entregas, y el registro de decisiones. El estado de cada entrega solo avanza hasta el paso que se ha comprobado de verdad: «승인 대기» (Esperando aprobación), «전달 중» (Entregando), «입력 접수 · 완료 미확인» (Entrada recibida · finalización sin confirmar), «실행 여부 불명» (Ejecución desconocida) o «완료» (Completado). Las peticiones de las que no se sabe si llegaron a ejecutarse no se reenvían automáticamente.

El panel de orquestación y las tareas también se pueden consultar y gestionar desde la PWA y la app de Android.

Permiso de líder de equipo

La coordinadora puede dar permiso de líder de equipo a una sesión de trabajo que dependa directamente de ella. El líder gestiona sus propias sesiones de trabajo dentro de los proyectos asignados y del límite de ejecuciones simultáneas. Si se le retira el permiso, las conversaciones y ejecuciones de sus sesiones siguen como estaban.

Delegar en otro PC

También puedes crear sesiones de trabajo en otro PC de tu cuenta que tengas enlazado desde 내 컴퓨터 (Mis equipos) en el rail. Para ello, el PC que las recibe también tiene que tener configurados sus permisos de orquestación.

  • Si el PC receptor está en 위임마다 승인 (Aprobar cada delegación), hay que aprobar en ese PC para que se ejecute. Si nadie responde a tiempo, se rechaza.
  • Si está en 자율 위임 (Delegación autónoma), se ejecuta en el acto.

Cada petición se ejecuta una sola vez. Si se pierde la respuesta por el camino, se comprueba con el registro de ese PC si llegó. El otro PC tiene que tener la misma versión o una posterior.

Reglas de limpieza

  • 종료 (Detener) solo detiene los procesos que lanzó Switchboard. La conversación, los datos para reanudarla y las relaciones se conservan.
  • Por defecto, las sesiones de trabajo inactivas detienen su proceso a los 15 minutos. Las que se detuvieron automáticamente después de informar su resultado pasan al archivo a los 60 minutos.
  • Las tareas que esperan una aprobación, una pregunta o una confirmación nunca se limpian automáticamente.
  • 탭 닫기 (Cerrar pestaña) no termina la sesión. Y una sesión archivada se puede restaurar y retomar.

En el modo supervisado (delegar tras tu aprobación), también esta limpieza necesita tu aprobación.