WolframAlphaAPI

El componente WolframAlphaAPI permite a los usuarios enviar consultas a la API de Wolfram Alpha y recibir respuestas en formato de texto. Es ideal para incorporar cálculos matemáticos, datos científicos o cualquier información que Wolfram Alpha pueda proporcionar directamente dentro de un flujo de trabajo de Nappai.

¿Cómo funciona?

Cuando el usuario escribe una pregunta o una expresión matemática en el campo Input, el componente envía esa cadena a la API de Wolfram Alpha usando la clave de aplicación (App ID) que el usuario ha configurado previamente como credencial. La API devuelve una respuesta en texto plano, que el componente encapsula en un objeto Data. Además, el componente expone una herramienta (Tool) que puede ser utilizada por otros módulos de Nappai para ejecutar la misma función de forma programática.

El flujo de trabajo interno es el siguiente:

Construcción del wrapper: Se crea una instancia de WolframAlphaAPICustomWrapper con el App ID proporcionado por la credencial.
Ejecución: Se llama al método run del wrapper con el valor de Input.
Resultado: El texto devuelto se envuelve en un objeto Data y se devuelve al flujo de trabajo. También se expone como una herramienta para ser reutilizada.

Entradas

Campos de Entrada

Input: Escribe la pregunta o expresión matemática que deseas enviar a Wolfram Alpha.
Ejemplo: What is the integral of sin(x) dx?

Nota importante:
Antes de usar el componente, debes configurar la credencial Wolfram Alpha API en la sección de credenciales de Nappai y luego seleccionarla en el campo Credential del componente. La credencial requiere el Wolfram Alpha App ID (clave secreta).

Salidas

Data: Un objeto que contiene el texto devuelto por Wolfram Alpha.
Uso típico: Mostrar la respuesta en un panel de texto o pasarla a otro componente que la procese.
Tool: Una herramienta que puede ser invocada por otros módulos de Nappai para ejecutar la misma consulta de forma programática.

Ejemplo de Uso

Añade el componente WolframAlphaAPI al flujo de trabajo.
Selecciona la credencial “Wolfram Alpha API” en el campo Credential.
En el campo Input, escribe:
```
What is the derivative of sin(x)?
```
Conecta la salida Data a un componente de visualización de texto.
Ejecuta el flujo y verás la respuesta:
```
cos(x)
```

Componentes Relacionados

LCToolComponent: Base sobre la que se construye este componente, permite la creación de herramientas reutilizables.
WolframAlphaAPICustomWrapper: Clase que encapsula la lógica de llamada a la API de Wolfram Alpha.

Consejos y Mejores Prácticas

Mantén tu App ID seguro: No lo compartas públicamente y utiliza la sección de credenciales de Nappai para gestionarlo.
Limita la longitud de las consultas: Las respuestas más largas pueden tardar más tiempo en procesarse.
Maneja errores: Si la API devuelve un error, muestra un mensaje claro al usuario y considera reintentar la consulta.

Consideraciones de Seguridad

La clave de aplicación (App ID) se almacena de forma segura en la sección de credenciales de Nappai; no se expone en el flujo de trabajo.
Asegúrate de que solo los usuarios autorizados tengan acceso a la credencial para evitar usos indebidos.