> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cambios

> correcciones de alcance de agente que abordan uno o más hallazgos, con un flujo de trabajo de borrador a publicado.

A **cambio** es una sugerencia atómica, agente-alcance que se dirige a un conjunto de
[hallazgos](/es/docs/findings) "reescribir la rama de detección de correo de voz del mensaje", por ejemplo, en respuesta a un grupo de *Correo de voz no detectado* Donde un hallazgo es el registro duradero de un *problema*El cambio es el registro de la
*fijar*: lo que va a cambiar, quién es el dueño, y lo lejos que está.

Un cambio está ligado a una [agente](/es/docs/agents)Hereda ese agente de los hallazgos de los que lo construyes, específicamente el primer agente en el hallazgo de siembra, por lo que un hallazgo sin agente no puede sembrar un cambio.

La sección Cambios de la barra lateral está oculta de forma predeterminada. Un
propietario o administrador puede activar o desactivar **Mostrar Cambios en la barra
lateral** en **Configuración → Organización → Tipos de cambio**. Los tipos de cambio
siempre están disponibles en este bloque. Ocultar el enlace de la barra lateral
conserva los cambios existentes y los enlaces directos.

## Proyecto vs. publicado

Cada cambio comienza la vida como un **proyecto**: una idea privada sin estado de flujo de trabajo, oculta de la lista principal de cambios. La lista tiene tres vistas
**Publicado**, **Borradores**, y **Todos** así que los borradores permanecen fuera de la lista de trabajo compartida hasta que alguien se despida. Un borrador deja el estado preliminar en una de dos maneras:

| Medidas adoptadas | Resultado |
| - | - |
| **Publicar** | Ir a la página `backlog` estado y se une a la lista publicada. |
| **Descartar** | Ir a la página `cancelled` status. |

`draft` Es una bandera separada de `status` un borrador simplemente no tiene estado todavía. No puedes establecer un estado de flujo de trabajo mientras un cambio sigue siendo un borrador; publícalo o deséchalo primero.

## Flujo de trabajo de estado

Una vez publicado, un cambio lleva uno de los cinco estados: `backlog`, `todo`,
`in_progress`, `done`, y `cancelled` Son estados de flujo de trabajo ordinarios: establezca lo que refleje la realidad, no hay progresión forzada.

## Anatomía de un cambio

| Campo | ¿Qué es? |
| - | - |
| **Título** | Título corto (opcional, hasta 255 caracteres). |
| **Descripción** | Texto enriquecido (Tiptap / ProseMirror JSON) el cambio propuesto, la lógica, los enlaces. |
| **agente** | El agente que el cambio apunta, derivado de sus hallazgos. |
| **Hallazgos** | Uno o más hallazgos vinculados se dirige al cambio. |
| **responsable** | El miembro de la org que posee la fijación (debe pertenecer a la org). |
| **Situación** | `null` Mientras que un borrador, entonces uno de los cinco estados de flujo de trabajo. |
| **Tipo** | El tipo de cambio see [tipos de cambio](#tipos-de-cambio). |
| **Generado** | Cuando se creó el cambio, un cambio puede ser redactado por una persona o sacado a la superficie por AI. |

## tipos de cambio

Cada cambio lleva un **tipo** que categoriza el tipo de trabajo que implica. Cinco tipos están integrados y disponibles para cada organización:

| Tipo | Desde |
| - | - |
| **Código cambio** | Código de aplicación o integración. |
| **cambio rápido** | Edita a la solicitud o instrucciones de un agente. |
| **Vigilancia** | Nuevas alertas, métricas o monitores. |
| **Estrategia** | Decisiones operativas o políticas de alto nivel. |
| **Genérico** | Cualquier cosa que no se ajuste a lo anterior (el valor predeterminado). |

Los propietarios y administradores pueden definir **tipos personalizados** para la organización bajo
**Configuración → Organization → cambios** dar a cada uno un nombre y un color. Un cambio predeterminado **Genérico**; establece su tipo desde la página de detalles del cambio o al redactarlo. Eliminar un tipo personalizado revierte cualquier cambio al volver a Generic.

## Actuando en un cambio

Desde la página de detalles de un cambio o su tarjeta en un [hallazgo](/es/docs/findings) algunas acciones se sitúan junto al título:

| Medidas adoptadas | Lo que hace |
| - | - |
| **Resuelve** | Abre el asistente en el producto en una nueva charla con un aviso que vincula este cambio y le pide que aplique el cambio, manteniendo el cambio de la [estado](#flujo-de-trabajo-de-estado) actualizada a medida que avanza. |
| **Copiar como mensaje** | Copia el cambio completo (título, resumen, enlaces a hallazgos) a tu portapapeles como un mensaje listo para ejecutar, para pegarlo en cualquier otra herramienta. |
| **Copiar enlace** | Copia un enlace directo al cambio. |

## Vinculación de hallazgos

Un cambio enlaza con Hallazgos a través de la `solution_findings` únete, y la relación es de muchos a muchos: un cambio puede abordar varios hallazgos, y puedes vincularlos o desvincularlos como tu cambio de comprensión. Eliminar un cambio elimina sus enlaces hallazgo en cascada, pero **nunca** elimina los hallazgos subyacentes: los problemas sobreviven a cualquier solución propuesta.

La página de detalles de un Hallazgo muestra los cambios vinculados a él, para que puedas rastrear la solución junto con el problema. [Hallazgos](/es/docs/findings).

## Acceso programático

Los cambios son **MCP-sólo** Hoy, no hay `/v1/changes` REST endpoint. Más [MCP](/es/docs/mcp) un agente puede redactar y gestionar de extremo a extremo:

* `list_solutions` / `get_solution` / `list_solution_findings` leer.
* `create_solution` borrador de un cambio (opcionalmente con un `type`). Se inserta exactamente **uno** Por lo tanto, nunca englobes varias ideas en un solo cuerpo, llámalo de nuevo para cada sugerencia distinta.
* `publish_solution` (→ `backlog`) / `discard_solution` (→ `cancelled`) salir del proyecto.
* `update_solution` editar título, descripción, estado o responsable.
* `link_finding_to_solution` / `unlink_finding_from_solution` gestionar los hallazgos vinculados.

Vea el [Referencia MCP](/es/docs/mcp#cambios) para esquemas completos de herramientas.

## Relacionado

* [Hallazgos](/es/docs/findings) los problemas que aborda un cambio.
* [Reportes](/es/docs/reports) análisis escritos de la operación en la que vive un cambio.
* [Agentes](/es/docs/agents) cada cambio está limitado a un agente.
* [Triage hallazgos](/es/docs/guides/triage-findings) el flujo de trabajo de un hallazgo a un cambio publicado.
* [MCP](/es/docs/mcp) elaborar y gestionar programas de cambio.
