Guías

¿Ya pasó antes? (antes de crear una issue)

Cómo evitar issues duplicadas con la búsqueda por significado y aqua.

tracker guarda una ficha de contexto de cada issue, escrita por aqua (el problema en palabras neutras, dónde ocurre y los términos que alguien usaría para contar el mismo problema de otra forma). "¿Ya pasó antes?" cruza esas fichas y aqua dice, de cada parecida, si es el mismo problema o solo relacionado, con el motivo en una frase. Los agentes usan el mismo camino para no abrir duplicadas:

  1. Antes de crear, pregunta: search_similar en el MCP (o GET /search) con query = título y descripción del problema (el mensaje de error, el relato del cliente). Para ver también los tickets de la Mesa de ayuda, kinds: ["issue", "ticket"].
  2. relation: "same" (el mismo problema): no crees otra. Comenta en la issue que ya existe (add_comment) con lo nuevo (otro cliente, otro entorno, la evidencia) y dile a la persona cuál es. Si la que existe ya se cerró y el problema volvió, crea la nueva y vincúlala con link_issues (duplicates), diciendo que volvió.
  3. relation: "related": créala y vincúlala con link_issues (relates_to); el reason explica la relación y sirve para el comentario.
  4. Después de crear, create_issue devuelve similar con las parecidas de la issue nueva que aqua confirmó (en la API, POST /issues?similar=true): vincula las que tengan sentido.

Sin aqua activada en la empresa, explained vuelve false y vale el likely_duplicate de la búsqueda. Para un lote (importación, CI), usa external_id, que ya evita repetir la misma issue.