Herramienta de análisis tabular

Próxima versión — Zylon 1.58Esta documentación se publica antes del lanzamiento para que puedas preparar tus integraciones de API. La imagen de la versión todavía no está disponible. Para instalaciones con 1.57, consulta la documentación de 1.57.

Usa Tabular Analysis para cálculos sobre datos tabulares (CSV/TSV o tablas extraídas).

Requisitos previos

Un token de API. Ver Backoffice Developer Console.
Artefactos tabulares ingeridos.

Requisitos

Especificación de la herramienta: { "name": "tabular_analysis", "type": "tabular_analysis_v1" }
tool_context: al menos un ingested_artifact con context_filter.

Solicitud y respuesta básicas

curl -X POST "https://{BASE_URL}/api/gpt/v1/messages/validate" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "default",
    "max_tokens": 128,
    "messages": [
      { "role": "user", "content": "What is the average of the Q1 revenue column?" }
    ],
    "tools": [
      { "name": "tabular_analysis", "type": "tabular_analysis_v1" }
    ],
    "tool_choice": { "type": "auto" },
    "tool_context": [
      {
        "type": "ingested_artifact",
        "context_filter": {
          "collection": "{collectionID}"
        }
      }
    ]
  }'

Ejemplo de respuesta:

{ "valid": true, "errors": null }

Para ejecutar, envía el mismo cuerpo a POST /messages.

Bloques de respuesta

Zylon ejecuta esta herramienta en el servidor. La respuesta contiene un bloque server_tool_use con la llamada, seguido de un bloque server_tool_result con el resultado. El ID de la llamada empieza por srvtoolu_. No envíes un tool_result de vuelta para ella.

[
  { "type": "server_tool_use", "id": "srvtoolu_3a4b", "name": "tabular_analysis", "input": { "query": "Average of the Q1 revenue column" } },
  {
    "type": "server_tool_result",
    "tool_use_id": "srvtoolu_3a4b",
    "content": [{ "type": "text", "text": "avg_q1_revenue\n18250.4" }],
    "is_error": false
  }
]

Error:

{ "type": "server_tool_result", "tool_use_id": "srvtoolu_3a4b", "content": "context_filter is required", "is_error": true }

is_error es true cuando la herramienta falla, y content contiene el mensaje de error. Consulta Migración de 1.57 a 1.58 para ver la lista completa de bloques de herramientas de servidor.

Consejos

Asegura que el contenido sea una tabla limpia.
Mantén tablas pequeñas para análisis rápido.

Próximos pasos

Ingesta de artefactos: Artefactos
Formato de mensajes: Mensajes

Primeros pasos

Construye con Zylon

Coding Agents

Herramienta de análisis tabular

Requisitos previos

Requisitos

Solicitud y respuesta básicas

Bloques de respuesta

Consejos

Próximos pasos

​Requisitos previos

​Requisitos

​Solicitud y respuesta básicas

​Bloques de respuesta

​Consejos

​Próximos pasos

Requisitos previos

Requisitos

Solicitud y respuesta básicas

Bloques de respuesta

Consejos

Próximos pasos