AlphaVantageTool

AlphaVantageTool es un componente que permite a los usuarios obtener datos financieros de Alpha Vantage directamente desde el dashboard de Nappai. Con él puedes consultar información de acciones, divisas, criptomonedas y más, sin tener que escribir código.

¿Cómo funciona?

El componente se conecta a la API pública de Alpha Vantage. Cuando lo ejecutas, envía una solicitud HTTP con tu token de API y el método que elijas (por ejemplo, “Ticker Info”). Alpha Vantage devuelve los datos en formato JSON, que el componente convierte en un objeto Data que puedes usar en el resto de tu flujo de trabajo. Además, el componente expone un objeto Tool que puede ser reutilizado por otros módulos de LangChain dentro de Nappai.

Entradas

Antes de usar el componente, asegúrate de haber configurado la credencial Alpha Vantage API en la sección de credenciales de Nappai y seleccionarla en el campo Credential del componente.

Campos de Entrada

• Information to request: Selecciona el tipo de información que deseas obtener de Alpha Vantage (por ejemplo, “Ticker Info” para datos de una acción específica).
• Input: Escribe el valor que se enviará a la API. Para “Ticker Info” suele ser el símbolo de la acción (por ejemplo, AAPL).

Salidas

• Data: Un objeto que contiene la respuesta de Alpha Vantage. Puedes usarlo para mostrar la información en tu dashboard o para alimentar otros componentes.
• Tool: Un objeto que representa la herramienta Alpha Vantage, útil si quieres integrarla en flujos de LangChain más complejos.

Ejemplo de Uso

1. Configura la credencial

   • Ve a Credenciales → Agregar credencial → Alpha Vantage API y pega tu token de API.
   • En el componente, selecciona esta credencial en el campo Credential.

2. Configura el componente

   • Information to request: Ticker Info
   • Input: AAPL

3. Ejecuta

   • El componente devolverá un objeto Data con la información de la acción AAPL (precio, volumen, etc.).
   • Puedes conectar la salida Data a un visualizador de tabla o a otro componente que necesite esos datos.

Componentes Relacionados

• AlphaVantageTool – La herramienta subyacente que realiza la llamada a la API.
• AlphaVantageAPI Credential – Credencial que almacena tu token de API.
• Data – Tipo de dato que se usa para transportar la respuesta dentro de Nappai.

Consejos y Mejores Prácticas

• Mantén tu token seguro: No lo compartas públicamente y revisa los permisos de la credencial en Nappai.
• Limita las llamadas: Alpha Vantage tiene límites de uso por minuto; si necesitas datos en tiempo real, considera usar su plan premium o almacenar resultados en caché.
• Valida la respuesta: Antes de usar los datos, verifica que la respuesta no contenga errores (por ejemplo, “Error Message” en el JSON).
• Usa filtros: Si solo necesitas ciertos campos, filtra la respuesta para reducir el tamaño de los datos que manejas.

Consideraciones de Seguridad

• La credencial Alpha Vantage API contiene tu token de acceso. Asegúrate de que solo usuarios autorizados tengan acceso a la sección de credenciales.
• Evita exponer la salida Data en interfaces públicas sin antes anonimizar o filtrar información sensible.