Toolkit de Ejecución de Node.js

Cómo llegar: Barra lateral principal > "Agentes" > Seleccione agente > Pestaña "Toolkits" > "Código y Desarrollo" > "Ejecución de Código Node.js"

1. Abra su agente > Pestaña "Toolkits" > Categoría "Código y Desarrollo" > Encuentre el toolkit "Ejecución de Código Node.js".
2. Haga clic en "Agregar al Agente" en Ejecución de Código Node.js, luego "Configurar". Haga clic en "Guardar".

Toolkit de Ejecución de Código Node.js

Ejecute código Node.js/JavaScript en un entorno sandbox seguro con soporte de paquetes NPM y capacidades de gestión de archivos. Optimizado para cargas de trabajo JavaScript/TypeScript, integraciones API, procesamiento JSON, operaciones asíncronas y automatización web.

Configuración del Toolkit Node.js

Configure el entorno sandbox de Node.js. Este toolkit permite al agente ejecutar código Node.js/JavaScript, subir archivos y gestionar archivos en el sandbox.

Información de Seguridad

• El código Node.js se ejecuta en un entorno sandbox seguro y aislado
• Cada sesión de chat obtiene su propio sandbox dedicado con estado persistente
• Los archivos subidos al sandbox están aislados de otros usuarios y proyectos
• Los sandboxes se limpian automáticamente después de que la sesión termina

Herramientas Disponibles (5/5)

Ejecución de Código:

• Ejecutar Código: Ejecute código Node.js/JavaScript en un entorno sandbox seguro

Gestión de Archivos:

• Buscar Archivos: Busque archivos en la base de conocimiento para subir al sandbox
• Subir Archivo: Suba archivos de la base de conocimiento al sandbox de Node.js
• Listar Archivos: Enumere todos los archivos actualmente disponibles en el sandbox
• Crear URL de Descarga: Cree URLs de descarga seguras para archivos en el sandbox

Casos de Uso

• Integración API: Llame a REST APIs y maneje flujos OAuth.
• Procesamiento JSON: Analice y transforme estructuras de datos JSON.
• Automatización Web: Extraiga datos de sitios web y automatice formularios.
• Transformación de Datos: Convierta entre formatos (CSV, JSON, XML, YAML).

Código de Ejemplo

A continuación se muestra un script de Node.js de ejemplo que demuestra el uso de paquetes NPM, verificación de dependencias y el patrón requerido de module.exports con una función de punto de entrada main():

const _ = require("lodash");
const PACKAGES = ["lodash", "@google-cloud/bigquery", "axios"];

const isPackageInstalled = (packageName) => {
    try {
        require.resolve(packageName);
        return true;
    } catch (e) {
        return false;
    }
};

const getPackageVersion = (packageName) => {
    if (!isPackageInstalled(packageName)) return {
        isInstalled: false,
        version: null,
        message: "Package is not installed",
        package: packageName,
    };

    const version = require(`${packageName}/package.json`).version;
    return {
        isInstalled: true,
        version,
        message: `Package is installed with version ${version}`,
        package: packageName,
    };
};

const test = () => {
    return _.map(PACKAGES, (pkg) => getPackageVersion(pkg));
};

async function main(inputText, maxLength = 100, options = {}) {
    /**
     * Main function that will be executed
     *
     * @param {string} inputText - The text to process
     * @param {number} maxLength - Maximum length of output (default: 100)
     * @param {object} options - Additional processing options (default: {})
     */

    return { data: test() };
}

// The entry point function will be called with the arguments you define
module.exports = { main };

Puntos Clave del Ejemplo

• Punto de Entrada: La función main() es el punto de entrada, exportado a través de module.exports = { main }.
• Paquetes NPM: Use require() para importar paquetes instalados (por ejemplo, lodash, axios, @google-cloud/bigquery).
• Verificación de Paquetes: Use require.resolve() para verificar si un paquete está disponible en el sandbox.
• Soporte Asíncrono: La función principal puede ser asíncrona para manejar llamadas API y operaciones de archivos.
• Parámetros: Defina parámetros con valores predeterminados (por ejemplo, maxLength = 100, options = {}) para entrada flexible.
• Formato de Retorno: Devuelva resultados como un objeto (por ejemplo, { data: ... }) para salida estructurada.