mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-04-25 08:26:21 +02:00
8954fa3ad7
Native CLI i18n: The TrustGraph CLI has built-in translation support that dynamically loads language strings. You can test and use different languages by simply passing the --lang flag (e.g., --lang es for Spanish, --lang ru for Russian) or by configuring your environment's LANG variable. Automated Docs Translations: This PR introduces autonomously translated Markdown documentation into several target languages, including Spanish, Swahili, Portuguese, Turkish, Hindi, Hebrew, Arabic, Simplified Chinese, and Russian.
120 lines
7.1 KiB
Markdown
120 lines
7.1 KiB
Markdown
---
|
|
layout: default
|
|
title: "Cambios en la CLI: v1.8 a v2.1"
|
|
parent: "Spanish (Beta)"
|
|
---
|
|
|
|
# Cambios en la CLI: v1.8 a v2.1
|
|
|
|
> **Beta Translation:** This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.
|
|
|
|
## Resumen
|
|
|
|
La CLI (`trustgraph-cli`) tiene importantes adiciones centradas en tres temas:
|
|
**explicabilidad/origen**, **acceso a embeddings** y **consultas en el grafo**.
|
|
Se eliminaron dos herramientas heredadas, una se renombró y varias herramientas existentes
|
|
adquirieron nuevas capacidades.
|
|
|
|
---
|
|
|
|
## Nuevas Herramientas CLI
|
|
|
|
### Explicabilidad y Origen
|
|
|
|
| Comando | Descripción |
|
|
|---------|-------------|
|
|
| `tg-list-explain-traces` | Lista todas las sesiones de explicabilidad (GraphRAG y Agent) en una colección, mostrando los IDs de sesión, tipo, texto de la pregunta y marcas de tiempo. |
|
|
| `tg-show-explain-trace` | Muestra la traza completa de explicabilidad para una sesión. Para GraphRAG: Etapas de Pregunta, Exploración, Enfoque, Síntesis. Para Agent: Etapas de Sesión, Iteraciones (pensamiento/acción/observación), Respuesta Final. Detecta automáticamente el tipo de traza. Soporta la opción `--show-provenance` para rastrear los bordes de vuelta a los documentos originales. |
|
|
| `tg-show-extraction-provenance` | Dados un ID de documento, recorre la cadena de origen: Documento -> Páginas -> Bloques -> Bordes, utilizando las relaciones `prov:wasDerivedFrom`. Soporta las opciones `--show-content` y `--max-content`. |
|
|
|
|
### Embeddings
|
|
|
|
| Comando | Descripción |
|
|
|---------|-------------|
|
|
| `tg-invoke-embeddings` | Convierte texto en un embedding vectorial a través del servicio de embeddings. Acepta uno o más entradas de texto, devuelve vectores como listas de flotantes. |
|
|
| `tg-invoke-graph-embeddings` | Consulta entidades del grafo por similitud de texto utilizando embeddings vectoriales. Devuelve las entidades coincidentes con puntuaciones de similitud. |
|
|
| `tg-invoke-document-embeddings` | Consulta fragmentos de documentos por similitud de texto utilizando embeddings vectoriales. Devuelve los IDs de fragmentos coincidentes con puntuaciones de similitud. |
|
|
| `tg-invoke-row-embeddings` | Consulta filas de datos estructurados por similitud de texto en campos indexados. Devuelve las filas coincidentes con valores de índice y puntuaciones. Requiere `--schema-name` y soporta `--index-name`. |
|
|
|
|
### Consultas en el grafo
|
|
|
|
| Comando | Descripción |
|
|
|---------|-------------|
|
|
| `tg-query-graph` | Consulta basada en patrones para el almacén de triples. A diferencia de `tg-show-graph` (que muestra todo), esto permite consultas selectivas para cualquier combinación de sujeto, predicado, objeto y grafo. Detecta automáticamente los tipos de valor: IRIs (`http://...`, `urn:...`, `<...>`), triples anclados (`<<s p o>>`), y literales. |
|
|
| `tg-get-document-content` | Recupera el contenido del documento de la biblioteca por ID de documento. Puede mostrar en un archivo o en stdout, maneja tanto contenido de texto como binario. |
|
|
|
|
---
|
|
|
|
## Herramientas CLI eliminadas
|
|
|
|
| Comando | Notas |
|
|
|---------|-------|
|
|
| `tg-load-pdf` | Eliminado. La carga de documentos ahora se maneja a través de la biblioteca/pipeline de procesamiento. |
|
|
| `tg-load-text` | Eliminado. La carga de documentos ahora se maneja a través de la biblioteca/pipeline de procesamiento. |
|
|
|
|
---
|
|
|
|
## Herramientas CLI renombradas
|
|
|
|
| Nombre antiguo | Nombre nuevo | Notas |
|
|
|----------|----------|-------|
|
|
| `tg-invoke-objects-query` | `tg-invoke-rows-query` | Refleja el cambio de terminología de "objetos" a "filas" para datos estructurados. |
|
|
|
|
---
|
|
|
|
## Cambios Significativos en Herramientas Existentes
|
|
|
|
### `tg-invoke-graph-rag`
|
|
|
|
- **Soporte de explicabilidad**: Ahora soporta una tubería de explicabilidad de 4 etapas (Pregunta, Fundamentación/Exploración, Enfoque, Síntesis) con visualización de eventos de origen en línea.
|
|
- **Streaming**: Utiliza el streaming de WebSocket para la salida en tiempo real.
|
|
- **Rastreo de origen**: Puede rastrear bordes seleccionados de vuelta a los documentos originales a través de la reificación y cadenas `prov:wasDerivedFrom`.
|
|
- Crecer de ~30 líneas a ~760 líneas para acomodar la tubería de explicabilidad completa.
|
|
|
|
### `tg-invoke-document-rag`
|
|
|
|
- **Soporte de explicabilidad**: Añadido el modo `question_explainable()` que transmite las respuestas de RAG de Documento con eventos de origen en línea (etapas de Pregunta, Fundamentación, Exploración, Síntesis).
|
|
|
|
### `tg-invoke-agent`
|
|
|
|
- **Soporte de explicabilidad**: Añadido el modo `question_explainable()` que muestra los eventos de origen en línea durante la ejecución del agente (etapas de Pregunta, Análisis, Conclusión, AgentThought, AgentObservation, AgentAnswer).
|
|
- El modo verboso muestra las transmisiones de pensamentos/observaciones con prefijos de emojis.
|
|
|
|
### `tg-show-graph`
|
|
|
|
- **Modo de streaming**: Ahora utiliza `triples_query_stream()` con tamaños de lote configurables para un tiempo de primer resultado más bajo y una menor sobrecarga de memoria.
|
|
- **Soporte de grafo nombrado**: Nueva opción `--graph` de filtro. Reconoce grafos nombrados:
|
|
- Grafo predeterminado (vacío): Hechos de conocimiento básicos
|
|
- `urn:graph:source`: Origen de extracción
|
|
- `urn:graph:retrieval`: Explicabilidad en tiempo de consulta
|
|
- **Mostrar columna de grafo**: Nueva bandera `--show-graph` para mostrar el grafo nombrado para cada triple.
|
|
- **Límites configurables**: Nuevas opciones `--limit` y `--batch-size`.
|
|
|
|
### `tg-graph-to-turtle`
|
|
|
|
- **Soporte de RDF-star**: Ahora maneja triples anclados (reificación de RDF-star).
|
|
- **Modo de streaming**: Utiliza streaming para un tiempo de procesamiento más rápido.
|
|
- **Manejo del formato de cable**: Actualizado para utilizar el nuevo formato de cable (`{"t": "i", "i": uri}` para IRIs, `{"t": "l", "v": value}` para literales, `{"t": "r", "r": {...}}` para triples anclados)
|
|
- **Soporte de grafo nombrado**: Nueva opción `--graph` de filtro.
|
|
|
|
### `tg-set-tool`
|
|
|
|
- **Nuevo tipo de herramienta**: `row-embeddings-query` para búsqueda semántica en índices de datos estructurados.
|
|
- **Nuevas opciones**: `--schema-name`, `--index-name`, `--limit` para configurar herramientas de consulta de embeddings de fila.
|
|
|
|
### `tg-show-tools`
|
|
|
|
- Muestra el nuevo tipo de herramienta `row-embeddings-query` con sus campos `schema-name`, `index-name` y `limit`.
|
|
|
|
### `tg-load-knowledge`
|
|
|
|
- **Informes de progreso**: Ahora cuenta y reporta los triples y contextos de entidad cargados por archivo y en total.
|
|
- **Actualización del formato de término**: Los contextos de entidad ahora utilizan el nuevo formato de término (`{"t": "i", "i": uri}`) en lugar del formato de valor antiguo (`{"v": ..., "e": ...}`).
|
|
|
|
---
|
|
|
|
## Cambios de rompimiento
|
|
|
|
- **Cambio de terminología**: El esquema `Value` se renombró a `Term` en todo el sistema (PR #622). Esto afecta al formato de cable utilizado por las herramientas CLI que interactúan con el almacén de grafos. El nuevo formato utiliza `{"t": "i", "i": uri}` para IRIs y `{"t": "l", "v": value}` para literales, reemplazando el formato antiguo `{"v": ..., "e": ...}`.
|
|
- **`tg-invoke-objects-query` renombrado** a `tg-invoke-rows-query`.
|
|
- **`tg-load-pdf` y `tg-load-text` eliminados**.
|