Salidas

​

Descripción General

• Definir el Formato de Respuesta - Cree esquemas JSON personalizados para las respuestas del agente
• Asegurar Consistencia - Garantice que los agentes siempre devuelvan datos en la misma estructura
• Habilitar Integración - Haga que las respuestas sean fácilmente consumibles por otros sistemas
• Mejorar el Análisis - Elimine la necesidad de análisis de texto complejo

​

Cómo Funciona

​

1. Cree un Esquema JSON

• Campos - Especifique campos requeridos y opcionales
• Tipos de Datos - Defina tipos (cadena, número, booleano, arreglo, objeto)
• Estructuras Anidadas - Cree objetos JSON anidados complejos
• Ejemplos - Proporcione valores de ejemplo para mayor claridad

​

2. Asigne al Agente

• Pestaña General - Elija entre las salidas estructuradas disponibles
• Específico del Agente - Cada agente puede usar un esquema diferente
• Selección Dinámica - Cambie esquemas según sea necesario

​

3. Respuesta del Agente

• Formatea como JSON - Devuelve respuestas en la estructura JSON especificada
• Sigue el Esquema - Incluye todos los campos requeridos
• Mantiene la Estructura - Preserva objetos anidados y arreglos
• Valida el Formato - Asegura que las respuestas coincidan con el esquema

​

Creación de Salidas Estructuradas

​

Paso 1: Acceda a la Pestaña de Salida

1. Navegue a Agentes en la barra lateral
2. Seleccione un agente o cree uno nuevo
3. Haga clic en Editar para abrir el agent builder
4. Vaya a la pestaña Salida

​

Paso 2: Cree un Nuevo Esquema

1. Haga clic en el botón Crear Nuevo
2. Ingrese un título descriptivo para su salida estructurada
3. Use el constructor JSON para definir su esquema

​

Paso 3: Defina la Estructura del Esquema

​

Estructura Básica

{
  "status": "string",
  "message": "string",
  "data": {
    "result": "string"
  }
}

​

Con Arreglos

{
  "items": [
    {
      "id": "string",
      "name": "string",
      "value": "number"
    }
  ],
  "total": "number"
}

​

Estructura Anidada Compleja

{
  "response": {
    "summary": "string",
    "details": {
      "category": "string",
      "subcategory": "string",
      "metadata": {
        "created_at": "string",
        "updated_at": "string"
      }
    },
    "items": [
      {
        "id": "string",
        "properties": {
          "name": "string",
          "value": "number"
        }
      }
    ]
  }
}

​

Paso 4: Guarde el Esquema

1. Haga clic en Guardar para almacenar su salida estructurada
2. El esquema ahora está disponible para uso en agentes

​

Asignación a Agentes

​

Método 1: Desde la Pestaña General

1. Abra el agente que desea configurar
2. Vaya a la pestaña General
3. Encuentre la sección Formato de Respuesta
4. Seleccione su salida estructurada del menú desplegable
5. Guarde el agente

​

Método 2: Desde la Pestaña de Salida

1. Abra el agente que desea configurar
2. Vaya a la pestaña Salida
3. Seleccione una salida estructurada de la lista
4. El agente usará este esquema para todas las respuestas

​

Casos de Uso

​

Integración de API

{
  "status": "success",
  "code": 200,
  "data": {
    "result": "string",
    "timestamp": "string"
  }
}

{
  "status": "success",
  "code": 200,
  "data": {
    "result": "Tarea completada exitosamente",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

​

Extracción de Datos

{
  "entities": [
    {
      "type": "string",
      "value": "string",
      "confidence": "number"
    }
  ],
  "summary": "string"
}

{
  "entities": [
    {
      "type": "person",
      "value": "John Doe",
      "confidence": 0.95
    },
    {
      "type": "company",
      "value": "TechCorp",
      "confidence": 0.88
    }
  ],
  "summary": "Se extrajeron 2 entidades del texto"
}

​

Informes Formateados

{
  "report": {
    "title": "string",
    "date": "string",
    "sections": [
      {
        "heading": "string",
        "content": "string",
        "metrics": {
          "value": "number",
          "unit": "string"
        }
      }
    ],
    "summary": "string"
  }
}

​

Automatización de Flujos de Trabajo

{
  "action": "string",
  "parameters": {
    "key": "value"
  },
  "next_step": "string",
  "metadata": {
    "workflow_id": "string",
    "step_number": "number"
  }
}

​

Mejores Prácticas

​

Diseño de Esquemas

1. Sea Específico - Defina claramente todos los campos y sus tipos
2. Use Ejemplos - Incluya valores de ejemplo en su esquema
3. Manténgalo Simple - Evite estructuras anidadas excesivamente complejas cuando sea posible
4. Documente los Campos - Use nombres de campos descriptivos
5. Considere Campos Opcionales - Marque campos como opcionales cuando sea apropiado

​

Nomenclatura de Campos

• Use Nombres Claros - user_name en lugar de un
• Sea Consistente - Siga una convención de nomenclatura (snake_case, camelCase)
• Evite Abreviaturas - Use palabras completas cuando sea posible
• Agrupe Campos Relacionados - Use objetos anidados para datos relacionados

​

Estructura del Esquema

• Plano Cuando Sea Posible - Prefiera estructuras planas para datos simples
• Anide para Organizar - Use anidamiento para datos complejos y relacionados
• Arreglos para Listas - Use arreglos para colecciones de elementos similares
• Objetos para Grupos - Use objetos para agrupar campos relacionados

​

Pruebas

1. Pruebe con Consultas Reales - Verifique que el esquema funciona con preguntas reales del usuario
2. Verifique Todos los Campos - Asegúrese de que todos los campos requeridos estén completos
3. Valide los Tipos - Confirme que los tipos de datos coincidan con el esquema
4. Maneje Casos Extremos - Pruebe con datos inusuales o faltantes

​

Gestión de Salidas Estructuradas

​

Ver Todos los Esquemas

• Listar Todos los Esquemas - Vea todas las salidas estructuradas de su proyecto
• Buscar - Encuentre esquemas por nombre
• Ordenar - Ordene por fecha de creación o título
• Ver Detalles - Vea la estructura del esquema y metadatos

​

Editar Esquemas

1. Haga clic en un esquema de la lista
2. Modifique la estructura JSON usando el constructor visual
3. Haga clic en Guardar para actualizar el esquema
4. Los cambios se aplican a todos los agentes que usan este esquema

​

Eliminar Esquemas

1. Encuentre el esquema en la lista
2. Haga clic en el ícono Eliminar
3. Confirme la eliminación
4. Los agentes que usan este esquema volverán a respuestas de texto normales

​

Formato de Respuesta

​

Respuesta Normal (Predeterminada)

El usuario solicitó información sobre el estado del proyecto.
El proyecto está actualmente en progreso con un 75% de finalización.
Todos los hitos están en curso.

​

Respuesta Estructurada

{
  "status": "in_progress",
  "completion_percentage": 75,
  "milestones": [
    {
      "name": "Fase 1",
      "status": "completed"
    },
    {
      "name": "Fase 2",
      "status": "in_progress"
    }
  ],
  "on_track": true
}

​

Integración con el Prompt del Sistema

1. Esquema Incluido - El esquema JSON se agrega al prompt del sistema
2. Instrucciones de Formato - El agente recibe instrucciones de formato explícitas
3. Ejemplo Proporcionado - El esquema sirve como formato de ejemplo
4. Validación - El agente intenta coincidir con la estructura exacta

​

Características Avanzadas

​

Valores Dinámicos de Campos

{
  "response_type": "string",
  "content": {
    "text": "string",
    "metadata": {}
  }
}

​

Estructuras Condicionales

{
  "type": "success|error|warning",
  "message": "string",
  "data": {} // La estructura varía según el tipo
}

​

Respuestas con Arreglos

{
  "count": "number",
  "items": [
    {
      "id": "string",
      "data": {}
    }
  ]
}

​

Solución de Problemas

​

El Agente No Sigue el Esquema

• El esquema no está asignado al agente
• La estructura del esquema es demasiado compleja
• El agente necesita instrucciones más claras

• Verifique que la salida estructurada esté seleccionada en la pestaña General
• Simplifique la estructura del esquema
• Agregue descripciones de campos más explícitas
• Pruebe con consultas más simples primero

​

Respuestas JSON Inválidas

• El esquema tiene errores de sintaxis
• El agente tiene dificultades con la estructura compleja
• Faltan campos requeridos

• Valide la sintaxis del esquema en el constructor JSON
• Verifique errores de validación JSON
• Simplifique el esquema si es demasiado complejo
• Revise las respuestas del agente en busca de errores de análisis

​

Campos Faltantes

• Los campos no están claramente definidos
• El agente no entiende los requisitos de los campos
• El esquema es demasiado vago

• Agregue descripciones claras de campos
• Proporcione valores de ejemplo en el esquema
• Haga que los campos sean opcionales si no siempre están disponibles
• Pruebe con consultas específicas

​

Ejemplos

​

Ejemplo 1: Respuesta de Soporte al Cliente

{
  "ticket_id": "string",
  "status": "open|resolved|pending",
  "response": "string",
  "next_actions": ["string"],
  "priority": "low|medium|high|urgent"
}

{
  "ticket_id": "TKT-12345",
  "status": "resolved",
  "response": "Su problema ha sido resuelto. El problema estaba relacionado con los permisos de la cuenta.",
  "next_actions": ["Actualice su navegador", "Cierre sesión y vuelva a iniciar"],
  "priority": "medium"
}

​

Ejemplo 2: Respuesta de Análisis de Datos

{
  "analysis": {
    "summary": "string",
    "findings": [
      {
        "category": "string",
        "insight": "string",
        "confidence": "number"
      }
    ],
    "recommendations": ["string"]
  },
  "data_points": "number"
}

{
  "analysis": {
    "summary": "Los datos de ventas muestran un aumento del 15% en Q4",
    "findings": [
      {
        "category": "ingresos",
        "insight": "Los ingresos aumentaron un 15% comparado con Q3",
        "confidence": 0.95
      },
      {
        "category": "clientes",
        "insight": "La adquisición de nuevos clientes aumentó un 20%",
        "confidence": 0.88
      }
    ],
    "recommendations": [
      "Continuar con la estrategia de marketing actual",
      "Enfocarse en la retención de clientes"
    ]
  },
  "data_points": 1250
}

​

Ejemplo 3: Respuesta de Gestión de Tareas

{
  "task": {
    "id": "string",
    "title": "string",
    "status": "todo|in_progress|completed",
    "assignee": "string",
    "due_date": "string",
    "description": "string"
  },
  "related_tasks": [
    {
      "id": "string",
      "title": "string"
    }
  ]
}

​

Permisos

​

Creación de Salidas Estructuradas

• Administrador del Proyecto - Puede crear, editar y eliminar salidas estructuradas
• Miembro del Proyecto - Depende de los permisos del proyecto (flows.edit)
• Visualizador - Puede ver pero no modificar salidas estructuradas

​

Uso en Agentes

• Propietario del Agente - Puede asignar salidas estructuradas a sus agentes
• Administrador del Proyecto - Puede asignar a cualquier agente del proyecto
• Miembro del Proyecto - Puede asignar a agentes a los que tiene acceso

​

Características Relacionadas

• Configuración del Agente - Configure la personalidad y comportamiento del agente
• Herramientas - Use herramientas que devuelvan datos estructurados
• Integración de API - Integre respuestas estructuradas con API externas
• Flujos de Trabajo - Use salidas estructuradas en flujos de trabajo automatizados

​

Soporte