A2A Card Reader

El A2A Card Reader es un componente sencillo que permite a los usuarios de Nappai obtener datos de tarjetas A2A desde servidores externos. Solo necesitas proporcionar una lista de URLs y el componente se encargará de consultar cada una para extraer la información que necesita.

¿Cómo funciona?

El componente toma la cadena de URLs que ingreses (separadas por comas), elimina espacios en blanco y realiza una petición HTTP GET a cada URL con la ruta .well-known/agent.json.
El servidor remoto devuelve un objeto JSON con la información de la tarjeta. El componente convierte ese JSON en un objeto Data que puede ser usado en el resto del flujo de trabajo de Nappai.

Entradas

URL

• Descripción: Especifica la dirección web de los agentes remotos que contienen la información de las tarjetas. Puedes ingresar una o varias URLs separadas por comas.

Salidas

• A2A Card Result: Devuelve una lista de objetos Data que contienen la información de cada tarjeta consultada. Esta salida puede ser conectada a otros componentes para procesar, visualizar o almacenar los datos.

Ejemplo de Uso

1. Añade el componente “A2A Card Reader” al flujo de trabajo.
2. En el campo URL, escribe:
   https://example.com, https://another.com
3. Conecta la salida A2A Card Result a un componente de visualización (por ejemplo, “Table Viewer”) para mostrar los datos de las tarjetas.

El flujo completo leerá los datos de ambas URLs y mostrará la información en una tabla dentro del dashboard.

Componentes Relacionados

• HTTP Request – Si necesitas más control sobre las peticiones HTTP, puedes usar este componente antes de pasar la URL al A2A Card Reader.
• Data Parser – Para transformar o filtrar los datos recibidos antes de mostrarlos.

Consejos y Mejores Prácticas

• Validar URLs: Asegúrate de que las URLs sean correctas y estén accesibles desde tu entorno Nappai.
• Manejo de errores: Si una URL falla, el componente lanzará una excepción. Puedes envolverlo en un bloque “Try/Catch” para manejar fallos sin detener todo el flujo.
• Limitar el número de URLs: Evita pasar demasiadas URLs de una sola vez para no sobrecargar el sistema.

Consideraciones de Seguridad

• Confianza en los servidores remotos: Solo consulta URLs de fuentes confiables, ya que el componente descarga y procesa datos sin filtrado.
• HTTPS: Usa siempre HTTPS para proteger la información durante la transmisión.
• Control de acceso: Si los datos de las tarjetas son sensibles, asegúrate de que el flujo de trabajo esté protegido por los permisos adecuados dentro de Nappai.