Objetivos
Los objetivos hacen que Kimi Code siga trabajando hacia un resultado definido a lo largo de varios turnos. A diferencia de una instrucción normal que indica qué hacer a continuación, un objetivo indica qué debe cumplirse. Usa /goal cuando la tarea tenga una meta clara, pero el siguiente paso útil dependa de lo que el agente descubra mientras trabaja: por ejemplo, arreglar un conjunto de pruebas que fallan o rastrear la causa raíz de una compilación rota.
Iniciar un objetivo
Escribe el objetivo después de /goal:
Kimi Code guarda el objetivo, lo envía como el siguiente mensaje del usuario e inicia el modo objetivo. Después de cada turno, verifica si el objetivo está completo, bloqueado, en pausa o aún activo.
Los objetivos funcionan mejor cuando el objetivo define la meta y la evidencia que la demuestra:
Evita los objetivos que solo indican una dirección general:
Ese objetivo no indica qué cuenta como éxito, qué inspeccionar ni cuándo detenerse. El agente puede bloquearse de inmediato o seguir trabajando mucho más de lo que esperabas.
Cuándo usar los objetivos
Usa los objetivos para trabajos con una meta clara y evidencia verificable.
Kimi Code puede inspeccionar el resultado de las pruebas, modificar archivos, volver a ejecutar verificaciones y decidir cuándo el objetivo está completo.
Usa los objetivos cuando la tarea pueda necesitar varios turnos de investigación y reparación.
El objetivo describe el resultado, así que el agente puede adaptarse cuando la primera pista no es la causa raíz.
Usa los objetivos para trabajos ordenados que deban continuar sin otra instrucción.
Esto resulta útil cuando ya conoces las verificaciones o los artefactos que deben existir antes de dar por terminado el trabajo.
Cuándo no usar los objetivos
No uses los objetivos para temas amplios o discusiones abiertas.
Contraejemplo:
Los agentes marcarán el objetivo como completo de inmediato si no se trata de un objetivo real.
No uses los objetivos para tareas que sabes que son imposibles o irresolubles.
Contraejemplo:
Los agentes marcarán el objetivo como bloqueado si parece imposible o irresoluble.
No uses los objetivos con metas ambiguas o complicadas.
Contraejemplo:
Los agentes pueden completar los objetivos, pero también pueden producir resultados inesperados o sorprendentes después de mucho tiempo.
Gestionar el ciclo de vida
Usa el mismo conjunto de comandos para inspeccionar o controlar el objetivo actual:
| Comando | Acción |
|---|---|
/goal o /goal status | Muestra el objetivo actual y su progreso |
/goal pause | Pausa el objetivo activo sin eliminarlo |
/goal resume | Reanuda un objetivo en pausa o bloqueado |
/goal cancel | Elimina el objetivo actual |
/goal replace <objetivo> | Reemplaza el objetivo actual con uno nuevo |
Un objetivo puede detenerse de tres maneras:
- completo: el objetivo está cumplido, Kimi Code lo borra y el agente resume cómo finalizó el trabajo
- en pausa: lo pausaste, interrumpiste el turno, reanudaste una sesión que tenía un objetivo activo o se produjo un error del modelo, del proveedor o del entorno de ejecución
- bloqueado: Kimi Code necesita información, no puede completar el objetivo tal como está planteado o alcanzó un límite de presupuesto. Cuando el agente bloquea un objetivo, escribe un mensaje breve explicando por qué.
Escribe las condiciones de detención dentro del objetivo. /goal no tiene un parámetro aparte para el límite de detención.
Poner en cola los próximos objetivos
A veces los agentes completan un objetivo demasiado rápido. Algunos usuarios se decepcionan al poder asignar solo un objetivo a la vez. Muchas personas ya saben qué próximos objetivos quieren perseguir. Tenían que esperar a que el objetivo actual se completara, abrir la TUI y enviar el siguiente objetivo manualmente.
Usa /goal next cuando tengas más trabajo listo pero no quieras interrumpir el objetivo actual:
Los próximos objetivos no son visibles para el agente mientras se ejecuta el objetivo actual. Cuando el objetivo actual se completa, Kimi Code inicia el primer objetivo en cola de la misma manera en que los usuarios escriben /goal <objetivo>.
Si no hay ningún objetivo activo, /goal next <objetivo> inicia ese objetivo de inmediato. Se comporta como /goal <objetivo> y muestra un mensaje de estado antes de que comience el objetivo.
Gestiona los próximos objetivos de forma interactiva:
En el gestor, usa ↑ / ↓ para navegar, Espacio para seleccionar un objetivo y moverlo, ↑ / ↓ para reordenarlo, E para editar, D para eliminar y Esc para cancelar. Al editar, usa Shift-Enter o Ctrl-J para agregar una nueva línea y Enter para guardar.
Si el objetivo actual está en pausa, cancelado o bloqueado, Kimi Code no inicia el siguiente objetivo en cola. Cuando un objetivo se bloquea y hay objetivos en cola, la TUI te recuerda que estos esperan a que se complete.
Usa el modo objetivo con cuidado
El modo objetivo es útil para trabajos que pueden verificarse con archivos, pruebas, salida de comandos, artefactos generados o un informe escrito claro. Es menos útil para una edición puntual o una pregunta que solo necesita una respuesta.
En el modo de permisos manual, el trabajo del objetivo puede pausarse para aprobar una llamada a una herramienta. Para trabajos sin supervisión, usa un modo de permisos acorde al riesgo del repositorio y a los comandos que el agente pueda ejecutar.
En el modo de instrucción no interactivo, solo se admite la creación de objetivos:
El modo de instrucción sale con el código 0 cuando el objetivo se completa, 3 cuando se bloquea y 6 cuando se pausa. /goal next y otros comandos de gestión son controles de la TUI.