Acciones seguras a través de chat, MCP e integración con Windows¶
El chat web y MCP utilizan el mismo catálogo de capacidades y servicios de dominio versionados. Por lo tanto, la lectura y escritura siguen las mismas comprobaciones de proyecto, rol, objeto y versión. Los dominios admitidos incluyen la biblioteca de pruebas, requisitos, planificación, ejecución, resultados, revisiones, relaciones, defectos, archivos adjuntos, conocimiento de lanzamiento y cambios, administración e importación o exportación de Word.
Una respuesta de IA o una vista previa de MCP no cambia los datos del proyecto. Las escrituras se preparan, revisan, confirman explícitamente y se auditan.
Prepare, revise, confirme y audite¶
- Preparar: Chat o MCP convierte la operación de dominio solicitada en una preparación concreta y verificada de permisos.
- Vista previa: Revise el objetivo, cambio propuesto, efectos, advertencias y, cuando corresponda, la versión esperada del objeto.
- Confirmar: Confirme solo una vista previa sin cambios que comprenda. Reinicie tras una expiración o conflicto de versión.
- Auditoría: Revise el resultado, enlace profundo y registro de auditoría. La idempotencia evita que un reintento técnico aplique silenciosamente el mismo cambio dos veces.
Permiso faltante, versión obsoleta, capacidad desconocida o argumentos inválidos fallan cerrados en lugar de aplicar una actualización parcial.
Configurar MCP con el menor privilegio¶
MCP usa JSON-RPC 2.0 en POST /mcp. Las claves API personales de proyecto operan con los roles y permisos de su usuario activo en el proyecto. Las claves administrativas globales son separadas; una clave global necesita aprobación explícita adicional antes de acceder a herramientas del proyecto.
- Cree claves en la administración prevista de claves MCP API y copie el secreto inmediatamente; no podrá mostrarse nuevamente.
- Utilice una vida útil corta, ámbitos mínimos y un propósito claro.
- Pase el ID único del proyecto o una ruta aprobada del proyecto en lugar de confiar en un contexto global implícito.
- Inspeccione el catálogo de herramientas y el explorador de capacidades antes de automatizar una operación.
- Revoque claves que ya no sean necesarias o que puedan haber sido expuestas.
Pasos de prueba reutilizables a través de MCP¶
Para pasos de prueba reutilizables, ztm_project_reusable_test_steps utiliza la capacidad project.reusable-test-step.read:
operation |
Otros argumentos | Resultado |
|---|---|---|
list |
opcional includeArchived |
Bloques permitidos con su revisión fija actual y huella digital |
detail |
blockID |
Contenido, historial de revisiones y usos permitidos |
composition |
testCaseVariantID |
Secciones y huella digital actuales de la variante de biblioteca |
Las escrituras usan ztm_project_action_prepare y ztm_project_action_commit. La clave API debe permitir la capacidad exacta de escritura; el acceso general de escritura es insuficiente. Proporcione estos arguments:
| Capacidad | Argumentos |
|---|---|
project.reusable-test-step.save |
block con ID (vacío al crear), TestUnitID, Title, StepsRaw, ExpectedRaw, Note, Archived; más expectedFingerprint (vacío al crear) |
project.reusable-test-step.composition.save |
testCaseVariantID, el completo ordenado sections, y expectedFingerprint |
project.reusable-test-step.composition.detach |
testCaseVariantID y expectedFingerprint |
Una sección reutilizable contiene BlockID y el Revision seleccionado explícitamente. Una sección local no tiene BlockID y contiene StepsRaw más ExpectedRaw opcional. El texto sin formato sigue el modo HTML o Markdown del proyecto. Conserve cada sección local sin cambios al guardar una composición. Un resultado esperado intencionadamente vacío permanece vacío.
save crea una nueva revisión fija; Archived: true archiva el bloque. No existe un comando de eliminación física ni actualización automática de todos los usos. Convierta una sección a contenido local reemplazando su referencia con sus textos sin procesar resueltos. El comando de separación convierte toda la composición guardada.
Revise el contenido antiguo y nuevo antes de comprometer, reutilice el mismo idempotencyKey para reintentos técnicos, y comprometa solo el previewToken devuelto. Vuelva a leer y prepare nuevamente después de un conflicto de huellas digitales. El servicio Runtime compartido verifica el acceso de lectura de origen y escritura de destino y rechaza pruebas rápidas. La sincronización existente devuelve skippedManagedContent para contenido histórico preservado: los pasos/resultados gestionados en ejecuciones existentes permanecen congelados mientras otros campos seleccionados pueden sincronizarse.
Puente local y acciones locales controladas¶
Zeta Test Local Bridge conecta flujos de trabajo web compatibles con funciones locales controladas de Windows. El servidor web no puede iniciar procesos locales arbitrarios. Chrome o Edge se comunican mediante la extensión del navegador con un host Native Messaging instalado, mientras que una política a nivel de máquina permite solo acciones nombradas y tipadas.
- Un administrador despliega el Native Host y la extensión del navegador, luego conecta solo el sitio web ZTM previsto.
- El departamento de TI del cliente define las acciones de proceso aprobadas en la política Local Bridge. Las líneas de comando libres y Lua heredado permanecen bloqueadas en el cliente web.
- Las herramientas externas usan una referencia estructurada como
ztm-local-bridge:action-id. Solo una acción instalada y aprobada por política puede ejecutarse. - Utilice la administración para verificar estado, versión, suma de verificación, puntos finales y los valores de política generados para Chrome o Edge.
Considere la extensión, Native Host, asociación de sitio y política local como un único límite de seguridad. Un puente conectado no reemplaza los permisos de proyecto u objeto.
Versiones de casos de prueba¶
ztm_project_test_case_versions lee versiones de caso de prueba a través de project.test-case-version.read. Listado, contenido, comparación, archivos históricos y vista previa aplican los mismos permisos de objeto que el cliente Web. La restauración usa la capacidad de escritura project.test-case-version.restore preparada y explícitamente confirmada; argumentos y flujo de trabajo también se describen en Capítulo REST.
Informes de calidad solo lectura¶
ztm_library_health_read (project.library-health.read) devuelve indicadores de revisión explicados para casos visibles de la biblioteca. ztm_test_stability_read (project.test-stability.read) devuelve cambios de resultados y grupos de fallos con evidencia de resultados de ejecuciones terminadas visibles. Ambos usan los servicios web y no requieren concesión de escritura. Los límites de visibilidad, análisis y evidencia de automatización cambiada permanecen explícitos; los indicadores no reemplazan una decisión empresarial. Los filtros, campos de respuesta y ejemplos REST se describen en Capítulo API.
ztm_project_planning_tree_read lee el árbol de planificación filtrado por estados de resultado personalizados. Consulte contrato de filtro. Esta operación de lectura no cambia configuraciones de vista personal.
Enlaces opcionales de Windows a funciones web¶
La capacidad project.presentation-settings.update incluye el booleano settings.showWindowsWebLinks. Está habilitado por defecto. Lea la configuración actual, cambie este campo, luego prepare y confirme explícitamente la actualización. Las cargas útiles antiguas que omiten este campo preservan su valor actual. El mismo contrato se aplica a través de MCP y REST, incluyendo derechos de administración de proyectos, verificaciones de alcance y protección contra vistas previas obsoletas.
Esto controla las entradas opcionales en menús y diálogos de Windows, no los permisos de acceso web. La orden explícita Abra en Web en la cinta permanece disponible. Vuelva a abrir el proyecto en Windows tras un cambio realizado por otro cliente.
Importar desde otra herramienta de pruebas¶
En la versión de desarrollo actual, utilice las herramientas MCP ztm_vendor_migration_preview y ztm_vendor_migration_apply para migración desde otra herramienta. El API REST describe sus parámetros compartidos, acceso de escritura y comportamiento de reintento.