Instrucciones de uso de la cadena de llamadas

Funcionalidad

La cadena de llamadas (también conocida como "trace") proporciona a los usuarios capacidades de observación en las conversaciones, ayudándoles a identificar el rendimiento específico de modelos, bases de conocimiento, MCP, búsquedas web, etc., durante el diálogo. Es una herramienta de observabilidad implementada mediante OpenTelemetry, que visualiza datos mediante recopilación, almacenamiento y procesamiento en el lado del cliente, proporcionando bases cuantitativas para localizar problemas y optimizar resultados.

Cada conversación corresponde a un dato de trace. Un trace consta de múltiples spans, donde cada span corresponde a una lógica de procesamiento en Cherry Studio, como llamadas a sesiones de modelos, MCP, bases de conocimiento o búsquedas web. El trace se muestra en estructura de árbol con spans como nodos, incluyendo datos principales como tiempo de ejecución y uso de tokens. En los detalles del span también pueden verse sus entradas y salidas específicas.

Activar Trace

Por defecto, después de instalar Cherry Studio, Trace permanece oculto. Debe activarse en "Configuración" → "Configuración general" → "Modo desarrollador", como se muestra:

Los diálogos anteriores no generarán registros de Trace. Solo se generarán registros tras nuevas interacciones de pregunta-respuesta. Los registros se almacenan localmente. Para eliminar completamente Trace, puede usar "Configuración" → "Configuración de datos" → "Directorio de datos" → "Borrar caché", o eliminar manualmente los archivos en ~/.cherrystudio/trace como se muestra:

Escenarios de uso

Visualización de toda la cadena

Haga clic en "Cadena de llamadas" dentro del cuadro de diálogo de Cherry Studio para ver datos completos de la cadena. Ya sea que el diálogo involucre modelos, búsquedas web, bases de conocimiento o MCP, todos los datos de llamada se mostrarán en la ventana de cadena de llamadas.

Inspección de modelos en la cadena

Para ver detalles de modelos en la cadena, haga clic en el nodo de llamada de modelo para inspeccionar sus entradas y salidas.

Inspección de búsquedas web en la cadena

Para ver detalles de búsquedas web, haga clic en el nodo correspondiente para examinar entradas y salidas. En los detalles podrá ver tanto la consulta como los resultados devueltos.

Inspección de bases de conocimiento en la cadena

Para ver detalles de bases de conocimiento, haga clic en el nodo correspondiente. Los detalles mostrarán la consulta realizada y las respuestas recuperadas.

Inspección de llamadas MCP en la cadena

Para ver detalles de MCP, haga clic en el nodo de llamada MCP. Los detalles mostrarán los parámetros de entrada pasados al tool MCP Server y las respuestas devueltas.

Problemas y sugerencias

Esta función es proporcionada por el equipo de EDAS de Alibaba Cloud. Para problemas o sugerencias, únase al grupo de DingTalk (ID de grupo: 21958624) para comunicarse directamente con los desarrolladores.