Generador de datos en formato CSV

Exporta un lote de registros de persona de ejemplo —generados en el servidor— como CSV (valores separados por comas): una fila de cabecera con los nombres de los campos y luego una fila de datos por persona. CSV es el formato de intercambio que esperan las hojas de cálculo, Excel, Google Sheets y muchos procesos ETL cuando necesitas datos de ejemplo tabulares planos.

Cómo funciona

Los objetos de persona sintéticos (nombre, sexo, fecha de nacimiento, campos de contacto y atributos relacionados) se serializan con peopleToCsv: las cabeceras de columna provienen de las claves del objeto, cada celda se convierte a texto y las filas se unen con comas y saltos de línea. Los objetos anidados se convierten en texto JSON dentro de una sola celda para que la cuadrícula siga siendo rectangular. No se requiere ninguna llamada al servidor adicional más allá de la propia generación de personas.

Cuándo usarlo

• Poblar demos de CRM o listas de correo en herramientas de hojas de cálculo
• Alimentar formularios de carga que solo aceptan CSV durante control de calidad
• Compartir registros de ejemplo con analistas que trabajan en Excel

Limitaciones

El entrecomillado CSV es mínimo: los valores con comas o comillas pueden necesitar limpieza manual en parsers estrictos. Las estructuras anidadas de municipio/país se convierten en texto JSON opaco dentro de una celda. La codificación es texto plano; abre los archivos como UTF-8 en tu hoja de cálculo. El tamaño del lote está limitado en el servidor por los mismos límites que el subtool generador.

Ejemplo

Dos personas podrían exportarse como:

firstName,lastName,gender,birthDate,email
Ada,Lovelace,F,1815-12-10,ada@example.com
Alan,Turing,M,1912-06-23,alan@example.com

Al abrir ese archivo en una hoja de cálculo se obtienen dos filas bajo esas cabeceras de columna.

Esta skill está disponible por A2A JSON-RPC y REST. Si ya conoce el skillId y el export, llame a execute directamente—sin descubrimiento.

Ejemplo REST

curl -sS -X POST https://toolplaza.app/api/helpers/execute \
  -H 'Content-Type: application/json' \
  -d '{"skillId":"people__csv","export":"peopleToCsv","args":[[{"firstName":"John","lastName":"Doe","gender":"M","email":"john.doe@example.com"}]]}'

Ejemplo A2A JSON-RPC

Send POST https://toolplaza.app/api/a2a with:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "message": {
      "messageId": "uuid",
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "ignored"
        }
      ]
    },
    "metadata": {
      "toolplaza": {
        "skillId": "people__csv",
        "export": "peopleToCsv",
        "args": [
          [
            {
              "firstName": "John",
              "lastName": "Doe",
              "gender": "M",
              "email": "john.doe@example.com"
            }
          ]
        ]
      }
    }
  }
}

Guía completa de la API de agentes · Esquema de la skill