Visión general

​

Requisitos previos

• Un token de API. Ver Backoffice Developer Console.
• El nombre de host de Zylon (sustituye {BASE_URL} en los ejemplos).

​

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": 64,
    "messages": [
      { "role": "user", "content": "Summarize: https://example.com/" }
    ],
    "tools": [
      { "name": "web_extract", "type": "web_extract_v1" }
    ],
    "tool_choice": { "type": "auto" }
  }'

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

​

Herramientas integradas

• Herramienta de búsqueda semántica
• Herramienta de análisis tabular
• Herramienta Web Fetch
• Herramienta Web Search
• Herramienta de consulta a base de datos

​

Herramientas personalizadas

​

Errores comunes

• Nombre de campo: usa inputSchema (no input_schema).
• Falta de contexto: algunas herramientas requieren tool_context.
• Autenticación: incluye Authorization: Bearer ... en cada petición.

​

Próximos pasos

• Formato de mensajes: Mensajes
• Ingesta de contenido: Artefactos