MCP y habilidades de Agent Observability
Este producto no es compatible con el
sitio Datadog seleccionado. (
).
Descripción general
El Datadog MCP Server permite que los agentes de IA accedan a sus datos de Agent Observability a través del Model Context Protocol (MCP). El conjunto de herramientas llmobs proporciona herramientas para buscar y analizar trazas, inspeccionar detalles y contenido de tramos, y evaluar resultados de experimentos directamente desde clientes basados en IA como Cursor, Claude Code u OpenAI Codex.
Configuración
Conecte un cliente compatible con MCP al Datadog MCP Server con el conjunto de herramientas llmobs habilitado.
Para obtener instrucciones de configuración completas, incluida la configuración de la extensión de Cursor y VS Code, consulte
Configurar el Datadog MCP Server.
Requisitos previos
- Una cuenta de Datadog con permiso para acceder a los datos de Agent Observability.
- Un cliente compatible con MCP (por ejemplo, Claude Code, Codex CLI, Cursor, Gemini CLI o Kiro CLI).
Punto de conexión
El punto de conexión del servidor MCP depende de su sitio de Datadog. Utilice el selector Datadog Site para mostrar el punto de conexión de su sitio. Agregue ?toolsets=llmobs,core para habilitar Agent Observability y los conjuntos de herramientas principales.
Punto de conexión para el sitio seleccionado ():
?toolsets=llmobs,core
Este producto no es compatible con el sitio seleccionado ().
Conectar
Elija la autenticación remota cuando sea posible. Utilice la autenticación binaria local si su entorno bloquea el flujo de OAuth remoto.
La autenticación remota utiliza el transporte Streamable HTTP de la especificación MCP.
Claude Code (línea de comandos):
claude mcp add --transport http datadog-mcp "?toolsets=llmobs,core"
Codex CLI (~/.codex/config.toml):
[mcp_servers.datadog]
url = ""
http_headers = { "X-Datadog-MCP-Toolsets" = "llmobs,core" }
Después de agregar la configuración, ejecute codex mcp login datadog para completar el flujo de OAuth.
Gemini CLI, Kiro CLI y otros clientes compatibles con MCP:
{
"mcpServers": {
"datadog": {
"type": "http",
"url": "?toolsets=llmobs,core"
}
}
}
Este producto no es compatible con el sitio seleccionado ().
La autenticación binaria local utiliza el transporte stdio de la especificación MCP. Utilice este método si la autenticación remota no está disponible.
Instale el binario de Datadog MCP Server:
curl -sSL https://coterm.datadoghq.com/mcp-cli/install.sh | bash
The binary installs to ~/.local/bin/datadog_mcp_cli.
Complete el flujo de inicio de sesión de OAuth:
Configure su cliente de IA. Para Claude Code, agregue lo siguiente a ~/.claude.json, reemplazando <USERNAME> en la ruta del comando:
{
"mcpServers": {
"datadog": {
"type": "stdio",
"command": "/Users/<USERNAME>/.local/bin/datadog_mcp_cli",
"args": [],
"env": {}
}
}
}
Alternatively, add the server with the Claude Code CLI:
claude mcp add datadog --scope user -- ~/.local/bin/datadog_mcp_cli
Autentíquese con claves de API
El servidor MCP utiliza OAuth 2.0 de forma predeterminada. Si OAuth no está disponible, envíe una clave de API y clave de aplicación de Datadog como los encabezados HTTP DD_API_KEY y DD_APPLICATION_KEY:
{
"mcpServers": {
"datadog": {
"type": "http",
"url": "?toolsets=llmobs,core",
"headers": {
"DD_API_KEY": "<YOUR_API_KEY>",
"DD_APPLICATION_KEY": "<YOUR_APPLICATION_KEY>"
}
}
}
}
Este producto no es compatible con el sitio seleccionado ().
Por seguridad, limite la clave de API y la clave de aplicación a una cuenta de servicio con solo los permisos necesarios.
Agent skills
Agent skills son conjuntos de instrucciones predefinidos para agentes de codificación de IA que automatizan los flujos de trabajo comunes de Agent Observability. El conjunto de habilidades agent-observability está disponible en el repositorio Datadog agent-skills. Proporciona seis habilidades para clasificar sesiones, diagnosticar fallas, analizar experimentos, generar código de experimento con el SDK ddtrace.llmobs y arrancar evaluadores con sus datos de producción en vivo.
Instalar
Instale las habilidades agent-observability con el siguiente comando:
npx skills add datadog-labs/agent-skills/agent-observability --full-depth -y
Las habilidades requieren que el llmobs conjunto de herramientas MCP esté conectado. Si aún no lo ha conectado, ejecute:
claude mcp add --scope user --transport http "datadog-llmo-mcp" \
'?toolsets=llmobs,core'
Este producto no es compatible con el sitio seleccionado ().
Reinicie Claude Code después de ejecutar ambos comandos para que aparezcan Agent skills.
Habilidades disponibles
| Skill | Invoke with | What it does |
|---|
| Clasificación de sesión | /agent-observability-session-classify | Clasifica si la intención del usuario fue satisfecha en una sesión, traza o lote |
| RCA de traza | /agent-observability-trace-rca | Análisis de causa raíz en trazas de producción fallidas |
| Analizador de experimentos | /agent-observability-experiment-analyzer | Analice y compare resultados de experimentos de LLM |
| Generación de código Python para experimentos | /agent-observability-experiment-py-bootstrap | Genere código de experimento en Python usando el ddtrace.llmobs SDK. Introspecciona su aplicación para conectar un task_fn real, autodescubre credenciales .env y acepta un --purpose de forma libre que dirige la selección del evaluador |
| Bootstrap de evaluación | /agent-observability-eval-bootstrap | Genere código de evaluador, publique evaluadores de LLM-judge en línea o muestree trazas en un conjunto de datos para su uso en un experimento |
| Canalización de evaluación | /agent-observability-eval-pipeline | Canalización guiada de seis fases desde trazas de producción hasta evaluadores, conjuntos de datos, experimentos y análisis. Detenga antes de tiempo con --stop-after, reanude a mitad del flujo con --start-at |
Clasificación de sesión
/agent-observability-session-classify clasifica si la intención del usuario fue satisfecha en una interacción determinada. Proviene de hasta tres fuentes de señales: rastreos de Agent Observability, datos de comportamiento RUM y eventos de Audit Trail. La habilidad devuelve un veredicto yes / partial / no con evidencia de respaldo. La confianza mejora con cada fuente de señal adicional.
/agent-observability-session-classify session_id=<SESSION_ID>
/agent-observability-session-classify trace_id=<TRACE_ID>
/agent-observability-session-classify ml_app=my-chatbot --timeframe now-7d
Análisis de causa raíz de traza
/agent-observability-trace-rca diagnostica por qué una aplicación de LLM está produciendo resultados deficientes. Selecciona un modo de análisis basado en la señal más fuerte disponible (veredictos de evaluación de LLM-judge, errores de tiempo de ejecución o anomalías estructurales) y compila un informe de RCA estructurado. El informe incluye una taxonomía de fallas y propuestas de solución BEFORE / AFTER concretas fundamentadas en la evidencia de traza.
Cuando Claude Code tiene acceso a su base de código, la habilidad puede buscar los archivos fuente relevantes y proponer diferencias en línea.
/agent-observability-trace-rca ml_app=my-chatbot
/agent-observability-trace-rca ml_app=my-chatbot eval_name=faithfulness --timeframe now-24h
Bootstrap de evaluador
/agent-observability-eval-bootstrap analiza las trazas de producción y propone un conjunto de evaluadores dirigidos a los modos de falla observados. Genera uno de cuatro artefactos: clases de Python BaseEvaluator / LLMJudge para experimentos fuera de línea, una especificación JSON independiente del marco, evaluadores de LLM-judge en línea publicados directamente en Datadog, o — a través de --emit-dataset <path> — un DatasetRecordRaw[] JSON muestreado de trazas de producción y adaptado para LLMObs.create_dataset(records=...). El modo dataset-emit omite el flujo de trabajo del evaluador por completo; produce un conjunto de datos adecuado para su uso como entrada de un experimento.
/agent-observability-eval-bootstrap ml_app=my-chatbot
/agent-observability-eval-bootstrap ml_app=my-chatbot --publish
/agent-observability-eval-bootstrap ml_app=my-chatbot --data-only
/agent-observability-eval-bootstrap ml_app=my-chatbot --emit-dataset ./datasets/my_chatbot_seed.json
Analizador de experimentos
/agent-observability-experiment-analyzer recupera los resultados del experimento y muestra qué cambió entre un candidato y una línea base: qué métricas mejoraron, cuáles retrocedieron y dónde el candidato tuvo un rendimiento inferior.
/agent-observability-experiment-analyzer experiment_id=<EXPERIMENT_ID>
/agent-observability-experiment-analyzer experiment_id=<CANDIDATE_ID> baseline_id=<BASELINE_ID>
Genere código de experimento con el SDK de Python
/agent-observability-experiment-py-bootstrap emite un script .py autónomo o un cuaderno .ipynb de Jupyter que utiliza el ddtrace.llmobs SDK y coincide con el estilo del notebook de referencia canónico.
El conjunto de datos puede ser un JSON DatasetRecordRaw[] local (integrado en el archivo), un CSV (cargado en tiempo de ejecución a través de LLMObs.create_dataset_from_csv), un conjunto de datos de Datadog existente por nombre (LLMObs.pull_dataset), o — de forma predeterminada — una pequeña muestra en línea de 3 registros. Cada experimento generado está etiquetado con generated_by=claude-code y el --purpose resuelto tanto en config como en tags.
/agent-observability-experiment-py-bootstrap --purpose "validate output accuracy"
/agent-observability-experiment-py-bootstrap --purpose "test tool selection" --dataset ./data/qa.json
/agent-observability-experiment-py-bootstrap --dataset-name <DATASET_NAME> --project-name <PROJECT_NAME>
/agent-observability-experiment-py-bootstrap --task-source mymodule.handlers:respond
Canalización de evaluación de extremo a extremo
/agent-observability-eval-pipeline recorre desde las trazas de producción hasta los evaluadores, conjuntos de datos, experimentos y análisis en seis fases narradas, con un punto de control para el usuario entre cada una:
- Clasificar trazas de ml_app — muestree y clasifique las trazas recientes de su
ml_app - Análisis de causa raíz — diagnostique por qué fallan las trazas que presentan errores
- Inicializar evaluadores — proponga un conjunto de evaluadores dirigido a los modos de falla observados
- Crear + publicar conjunto de datos — extraiga pares de entrada / expected_output en un
DatasetRecordRaw[] JSON y publíquelos en Datadog bajo su proyecto (creado de forma diferida) - Generar + ejecutar experimento — emita un
.py o .ipynb ejecutable que extraiga el conjunto de datos y conecte la función de tarea de su aplicación, luego ejecútelo de extremo a extremo y capture experiment.url. Un punto de revisión en fase (run / edit / stop) se sitúa entre la generación de código y la ejecución para que pueda inspeccionar el archivo generado antes de su ejecución - Analizar experimento — produzca un informe de análisis con desgloses de métricas y recomendaciones
Cada fase tiene un nombre corto canónico: el mismo valor aceptado por --start-at y --stop-after. La tabla a continuación enumera, por fase, qué herramientas MCP puede invocar la canalización y una descripción de una línea de la lógica:
| # | Título de la fase | Nombre de la etapa | Herramientas MCP llamadas | Resumen |
|---|
| 1 | Clasificar trazas de ml_app | classify | search_llmobs_spans | Muestrea tramos raíz recientes para la ml_app, clasifica cada uno como éxito / parcial / falla, muestra patrones comunes. |
| 2 | Análisis de causa raíz | rca | search_llmobs_spans | Extrae trazas completas para los tramos fallidos de la Fase 1 y recorre el árbol de trazas para atribuir cada falla a un tramo raíz y un modo de falla. |
| 3 | Inicializar evaluadores | eval-bootstrap | Ninguno (razonamiento local sobre el informe de la Fase 2); llamada opcional a la Datadog API para publicar evaluadores de jueces LLM en línea cuando --publish está configurado | Emite un conjunto de evaluadores de Python (sdk_code), una especificación JSON agnóstica al marco (data_only), o publica evaluadores en línea (publish). |
| 4 | Crear y publicar conjunto de datos | dataset | search_llmobs_spans para muestreo; LLMObs.create_dataset() a través del SDK de ddtrace (no MCP) para publicar | Muestrea tramos raíz, extrae pares de entrada / expected_output, limpia PII, escribe un JSON local, luego publica en Datadog. |
| 5 | Generar y ejecutar experimento | experiment | list_llmobs_evals (beacon de inicio de un solo intento — conectividad + telemetría); el tiempo de ejecución utiliza el SDK de ddtrace | Introspecciona su aplicación en busca de sitios de llamadas a LLM, emite un .py autónomo o .ipynb conecta task_fn a un punto de entrada real, luego lo ejecuta. |
| 6 | Analizar experimento | analyze | get_llmobs_experiment_summary, get_llmobs_experiment_metric_values, list_llmobs_experiment_events, get_llmobs_experiment_event, get_llmobs_experiment_dimension_values | Extrae métricas generales, puntuaciones por registro, dimensiones de segmento y eventos de desglose; sintetiza un informe de análisis estructurado. |
Deténgase de forma ordenada stop en cualquier punto de control y reanude más tarde con --start-at <stage-name> — sin necesidad de volver a ejecutar. Pase --stop-after eval-bootstrap para preservar el comportamiento clásico de solo evaluación de tres fases.
/agent-observability-eval-pipeline my-chatbot --project-name my-chatbot
/agent-observability-eval-pipeline my-chatbot --stop-after eval-bootstrap # classic 3-phase
/agent-observability-eval-pipeline my-chatbot --start-at experiment # resume mid-flow
/agent-observability-eval-pipeline my-chatbot --start-at analyze --experiment-id <UUID>
Para obtener una guía completa sobre estas habilidades y un flujo de trabajo de extremo a extremo recomendado, consulte Analizar LLM Applications with Claude Code Skills.
Casos de uso
Las herramientas MCP de Agent Observability permiten flujos de trabajo asistidos por IA para:
- Depuración de la ejecución del agente: Busque trazas por aplicación de ML, estado de error o etiquetas personalizadas, luego examine las jerarquías y el contenido de los tramos para identificar fallas.
- Analizando la estructura de trazas: Visualice el árbol completo de tramos de una traza para comprender cómo interactúan los agentes, LLMs, herramientas y recuperaciones.
- Investigando bucles de agentes: Revise el bucle de ejecución paso a paso de un agente para comprender la toma de decisiones y los patrones de invocación de herramientas.
- Evaluando experimentos: Obtenga estadísticas resumidas para las métricas de experimentos, compare resultados entre segmentos de dimensiones e inspeccione eventos individuales.
- Creando experimentos: Registre un nuevo objeto de experimento con
create_llmobs_experiment para registrar metadatos del experimento (proyecto, conjunto de datos, descripción, configuración) sin ejecutar la inferencia del modelo. Adjunte métricas de evaluación posteriormente con submit_llmobs_experiment_events. - Descubriendo patrones de experimentos: Filtre y ordene eventos de experimentos por rendimiento de métricas para encontrar los casos con mejor y peor rendimiento.
- Gestionando evaluadores: Enumere, inspeccione, cree, actualice y elimine configuraciones de evaluadores en una aplicación de ML o en toda la organización.
- Explorando patrones: Enumere configuraciones de patrones, verifique el estado de ejecución y explore la jerarquía de temas descubierta para comprender qué están preguntando los usuarios y cómo se distribuye el tráfico.
- Gestionando conjuntos de datos: Busque proyectos y conjuntos de datos, explore e inspeccione registros de conjuntos de datos y agregue nuevos registros a un conjunto de datos para su uso en experimentos.
El conjunto de herramientas llmobs incluye las siguientes herramientas:
search_llmobs_spans- Busque tramos que coincidan con filtros o una consulta sin procesar.
get_llmobs_trace- Obtenga la estructura completa de una traza como un árbol de jerarquía de tramos, incluyendo conteos de tramos por tipo, indicadores de error y duración total.
get_llmobs_span_details- Obtenga metadatos detallados de uno o más tramos, incluyendo tiempos, información de errores, detalles de LLM (modelo, conteo de tokens), métricas y evaluaciones.
get_llmobs_span_content- Recupere el contenido real de un campo de tramo (entrada, salida, mensajes, documentos o metadatos) con extracción JSONPath opcional.
find_llmobs_error_spans- Encuentre todos los tramos de error en una traza con contexto de propagación, agrupados por tipo de tramo con mensajes de error y trazas de pila.
expand_llmobs_spans- Cargue los hijos de tramos específicos para la exploración progresiva del árbol cuando
get_llmobs_trace devuelva nodos contraídos. get_llmobs_agent_loop- Obtenga una vista cronológica del bucle de ejecución de un agente, mostrando cada paso (llamadas a LLM, invocaciones de herramientas, decisiones) en orden.
create_llmobs_experiment- Cree un nuevo objeto de experimento de Agent Observability en un proyecto. Registra el experimento (para que los eventos y métricas puedan reportarse en relación con él) sin ejecutar ninguna inferencia de modelo. Requiere
project_id y experiment_name. Devuelve el experiment_id creado y su nombre resuelto. Use submit_llmobs_experiment_events para adjuntar métricas de evaluación, o update_llmobs_experiment para cambiar sus propiedades. get_llmobs_experiment_summary- Obtenga un resumen de experimento de alto nivel con estadísticas precalculadas para todas las métricas de evaluación. Comience aquí antes de usar otras herramientas de experimento.
list_llmobs_experiment_events- Enumere los eventos de experimento con filtrado por dimensión o métrica y ordenamiento por valor de métrica.
get_llmobs_experiment_event- Obtenga detalles completos de un solo evento de experimento, incluyendo entrada, salida, expected_output, todas las métricas y dimensiones.
get_llmobs_experiment_metric_values- Obtenga análisis estadístico para una métrica de evaluación específica, opcionalmente segmentado por una dimensión para comparación.
get_llmobs_experiment_dimension_values- Obtenga valores únicos para una dimensión con conteos, útil para descubrir valores válidos de filtro y segmento.
list_llmobs_evals- Enumere todos los evaluadores de LLM-judge configurados en todas las aplicaciones de ML. Devuelve el nombre, ml_app y estado habilitado de cada evaluador.
list_llmobs_evals_by_ml_app- Enumere todos los evaluadores de LLM-judge configurados para una aplicación de ML específica.
list_llmobs_feedback_labels- Listar todas las etiquetas de comentarios enviadas por los usuarios finales para una aplicación de ML específica.
get_llmobs_evaluator- Recupere una configuración de evaluador de LLM-judge por nombre, incluyendo su objetivo (ml_app, muestreo, filtro), proveedor de LLM y plantilla de prompt del evaluador.
create_or_update_llmobs_evaluator- Cree o actualice una configuración de evaluador de LLM-judge. Dirigido a una aplicación de ML específica y opcionalmente a un filtro o porcentaje de muestreo; el modelo del evaluador y la plantilla de prompt definen cómo califica cada tramo.
delete_llmobs_evaluator- Elimine una configuración de evaluador de LLM-judge por nombre.
list_llmobs_projects- Listar todos los proyectos de experimentos de Agent Observability para la organización, ordenados por fecha de creación (los más recientes primero). Devuelve el
id, name y las marcas de tiempo de cada proyecto, además de los campos de paginación (next_cursor, truncated). Utilice esto para descubrir nombres e identificadores de proyectos cuando aún no los conozca. get_llmobs_project- Busque un proyecto de experimentos de Agent Observability por ID o nombre. Use esto para resolver un
project_id UUID antes de llamar a las herramientas de conjuntos de datos. list_llmobs_datasets- Listar los conjuntos de datos dentro de un proyecto, con filtro opcional de ID o nombre. Devuelve los metadatos del conjunto de datos y los campos de paginación. Use esto antes de
get_llmobs_dataset_records o add_llmobs_dataset_records; esas herramientas requieren un UUID de conjunto de datos. get_llmobs_dataset_records- Lea registros de conjuntos de datos con vistas previas estructuradas y un resumen del esquema. Da forma a campos JSON arbitrarios (
input, expected_output, metadata) en vistas previas legibles. Use compute_schema=true para obtener un esquema de la estructura de registros con reconocimiento de tipos antes de crear nuevos registros. get_llmobs_full_dataset_records- Obtenga hasta 3 registros específicos con contenido completo y sin recortar. Use esto para inspeccionar registros individuales en detalle después de encontrar los ID de registro con
get_llmobs_dataset_records. add_llmobs_dataset_records- Cree registros en un conjunto de datos utilizando un flujo de dos pasos de vista previa y confirmación. Llame con
confirmed=false para obtener una vista previa de la escritura planificada, luego confirmed=true para confirmar después de la aprobación del usuario.
list_llmobs_pattern_configs- Listar todas las configuraciones de Patterns para la organización. Devuelve el
id, name, evp_query, la configuración de muestreo y las marcas de tiempo de cada configuración. Comience aquí para encontrar un config_id. get_llmobs_pattern_config- Obtenga la configuración de Patterns modificada más recientemente para la organización.
get_llmobs_pattern_run_status- Obtenga el estado y el progreso por actividad de la ejecución de Patterns más reciente para una configuración. Use esto para verificar si el clúster se está ejecutando, se completó o falló antes de leer los temas.
list_llmobs_pattern_runs- Listar todas las ejecuciones de Patterns completadas para una configuración, de la más nueva a la más antigua. Devuelve el
id, status, las marcas de tiempo y el config_snapshot utilizado de cada ejecución. get_llmobs_patterns- Obtenga la jerarquía de temas descubierta por una ejecución de Patterns. Los temas están organizados en niveles, cada uno con un
name, description y point_count. Omita run_id para leer la ejecución completada más reciente. get_llmobs_patterns_with_points- Obtenga la jerarquía de temas para una ejecución con IDs de tramo integrados en cada tema hoja. Establezca
include_metrics=true para incluir también la duración, el costo, el conteo de tokens y las evaluaciones por tramo. get_llmobs_pattern_points- Obtenga una página paginada por cursor de puntos de clúster (tramos individuales) asignados a un solo tema. Cada punto incluye el
span_id, session_id y una vista previa de la entrada del tramo. Pase next_page_token de vuelta como page_token para continuar con la paginación.
list_llmobs_annotation_queues- Listar todas las colas de anotación para la organización.
create_llmobs_annotation_queue- Crear una cola de anotación para la revisión humana de trazas, definiendo opcionalmente su esquema de etiquetas en el momento de la creación.
update_llmobs_annotation_queue- Actualizar el nombre, la descripción o el esquema de etiquetas de una cola de anotación.
delete_llmobs_annotation_queue- Eliminar una cola de anotación.
get_llmobs_annotation_label_schema- Obtener el esquema de etiquetas para una cola de anotación, el cual define las etiquetas que los anotadores aplican durante la revisión.
update_llmobs_annotation_label_schema- Cree o reemplace el esquema de etiquetas para una cola de anotación.
add_llmobs_annotation_queue_interactions- Agregue una o más trazas a una cola de anotación para su revisión.
delete_llmobs_annotation_queue_interactions- Elimine trazas de una cola de anotación.
get_llmobs_annotated_interactions- Obtenga las interacciones anotadas en una cola de anotación junto con las etiquetas que los anotadores les aplicaron.
get_llmobs_annotations_by_content_ids- Obtenga las anotaciones aplicadas a trazas o sesiones específicos mediante sus ID de contenido.
upsert_llmobs_annotations- Cree o actualice las anotaciones aplicadas a las interacciones en una cola.
delete_llmobs_annotations- Elimine las anotaciones aplicadas a las interacciones en una cola.
Flujos de trabajo recomendados
Análisis de trazas
- Buscar: Use
search_llmobs_spans para encontrar trazas por aplicación de ML, estado, tipo de tramo o etiquetas personalizadas. - Visualizar: Use
get_llmobs_trace para ver el árbol de jerarquía de tramos completo. - Inspeccionar: Use
get_llmobs_span_details para obtener metadatos, tiempos y evaluaciones para tramos específicos. - Leer contenido: Use
get_llmobs_span_content para recuperar la E/S, los mensajes o los documentos reales. - Depurar errores: Use
find_llmobs_error_spans para localizar todos los errores en una traza con contexto de propagación. - Expandir: Use
expand_llmobs_spans para cargar los hijos de los tramos contraídos para una exploración más profunda. - Revisión de Agent: Use
get_llmobs_agent_loop para ver el flujo de ejecución paso a paso de un tramo de Agent.
Análisis de experimentos
- Resumir: Use
get_llmobs_experiment_summary para obtener estadísticas generales y descubrir las métricas y dimensiones disponibles. - Explorar eventos: Use
list_llmobs_experiment_events para encontrar eventos de interés, filtrando por dimensión u ordenando por métrica. - Inspeccionar eventos: Use
get_llmobs_experiment_event para ver los detalles completos de un evento específico. - Analizar métricas: Use
get_llmobs_experiment_metric_values para obtener distribuciones de percentiles, tasas de verdadero/falso o comparar entre segmentos de dimensión. - Descubrir dimensiones: Use
get_llmobs_experiment_dimension_values para encontrar valores válidos de filtro y segmento.
Gestión de conjuntos de datos
- Encuentre su proyecto: Use
list_llmobs_projects para explorar proyectos; cada resultado incluye el id UUID que necesita para llamadas posteriores. Si ya conoce el nombre del proyecto pero no su UUID, use get_llmobs_project para resolverlo directamente. - Encuentre su conjunto de datos: Use
list_llmobs_datasets con el project_id para listar conjuntos de datos y obtener sus UUIDs. - Entienda los datos: Use
get_llmobs_dataset_records con compute_schema=true para explorar registros y obtener un esquema de tipos de los campos antes de leer o escribir. - Leer registros específicos: Use
get_llmobs_full_dataset_records para recuperar el contenido completo de hasta 3 registros por ID. - Agregar registros: Use
add_llmobs_dataset_records con confirmed=false para obtener una vista previa de una escritura, luego confirmed=true después de la aprobación del usuario.
Análisis de patrones
- Listar configuraciones: Use
list_llmobs_pattern_configs para encontrar las configuraciones de Patrones disponibles y sus valores de config_id. - Verificar el estado de ejecución: Use
get_llmobs_pattern_run_status para verificar que la ejecución más reciente esté completa. - Leer temas: Use
get_llmobs_patterns para obtener la jerarquía completa de temas con nombres, descripciones y puntuaciones de coherencia. - Inspeccionar tramos: Use
get_llmobs_patterns_with_points para obtener temas con IDs de tramo integrados, o get_llmobs_pattern_points para navegar por los tramos de un tema específico. - Analizar el contenido del tramo: Use
get_llmobs_span_details o get_llmobs_span_content con los valores de span_id del paso anterior para inspeccionar las entradas, salidas y metadatos reales de tramos individuales dentro de un tema. - Explorar ejecuciones pasadas: Use
list_llmobs_pattern_runs para ver ejecuciones históricas y pase un run_id específico para comparar las distribuciones de temas a lo largo del tiempo.
Ejemplos de prompts
Después de conectarse, pruebe prompts como:
- Revise las trazas de errores de mi aplicación
customer-support-bot durante la última semana. Resuma los patrones de falla más comunes, con qué frecuencia ocurren y recomiende cuáles corregir primero. - Encuentre trazas donde las respuestas de mi Agent fueron marcadas por las evaluaciones como de baja calidad. Examine las entradas y salidas, luego sugiera cambios específicos en mi prompt del sistema para mejorar la calidad de la respuesta.
- Examine las trazas recientes del Agent para mi aplicación y encuentre casos donde el Agent entró en bucle más de lo necesario. Analice la toma de decisiones en cada paso y sugiera cómo mejorar las descripciones de mis herramientas para reducir las llamadas innecesarias a herramientas.
- Un usuario informó una mala respuesta. Aquí está el ID de traza:
trace-123. Explíqueme exactamente qué sucedió: qué preguntó el usuario, qué hizo el Agent en cada paso y dónde salieron mal las cosas. Sugiera una corrección de código. - Analice el experimento
exp-456 y genere una tabla en formato markdown de las dimensiones con peor rendimiento desglosadas por puntuaciones de evaluación. Incluya cualquier otra columna relevante que me ayude a entender dónde y por qué está disminuyendo el rendimiento. - Compare el experimento
exp-123 (línea base) con el experimento exp-456. Resuma qué mejoró, qué empeoró y en qué medida. Deme una recomendación sobre si vale la pena implementar los cambios. - Resuma el experimento
exp-456 e identifique los 5 eventos con la puntuación más baja. Para cada uno, muestre la entrada, la salida y qué evaluaciones fallaron. - Cree un nuevo experimento llamado "prompt-v2-test" en mi proyecto
my-chatbot-project y devuelva su ID de experimento para que pueda adjuntarle métricas de evaluación. - Listar los conjuntos de datos en mi proyecto
my-project y muéstreme una muestra de registros del conjunto de datos llamado qa-golden-set, incluido su esquema. - Tengo un archivo CSV con nuevos casos de prueba. Agréguelos al conjunto de datos
qa-golden-set en my-project como una nueva versión. Muéstreme una vista previa primero.
El conjunto de herramientas core incluido en la URL de configuración le da a su Agent de IA acceso a herramientas adicionales de Datadog que se combinan naturalmente con el análisis de Agent Observability.
Exporte el análisis a Datadog Notebooks
El conjunto de herramientas core incluye create_datadog_notebook y edit_datadog_notebook, que permiten a su Agent de IA crear Datadog Notebooks directamente a partir de los resultados del análisis. Puede exportar los hallazgos de los chats del Agent a un notebook colaborativo y compartible que reside en Datadog junto con sus trazas y experimentos.
Pruebe con sugerencias como:
- Analice el experimento
exp-456, identifique las dimensiones con peor rendimiento y exporte un informe resumido a un Datadog Notebook con un desglose por puntuaciones de evaluación. - Revise las trazas de error de mi
customer-support-bot durante la última semana y cree un Datadog Notebook con los hallazgos, incluyendo patrones de falla comunes y soluciones recomendadas.
Para visualizaciones personalizadas que van más allá de los widgets estándar de Datadog, como gráficos de comparación o diagramas de cuadrantes, los Notebooks también renderizan diagramas Mermaid de forma nativa. Pruebe con sugerencias como:
- Analice el experimento
exp-456, compare las puntuaciones de accuracy en cada versión del prompt y exporte los resultados a un Datadog Notebook que incluya un gráfico de barras Mermaid del promedio de puntuación para cada versión. - Analice el experimento
exp-456 y exporte un Datadog Notebook que grafique cada versión del prompt en un diagrama de cuadrantes Mermaid con relevance en un eje y accuracy en el otro. Identifique qué versiones tienen un rendimiento inferior en ambas dimensiones.
Lecturas adicionales
Documentación, enlaces y artículos útiles adicionales: