Ps. ¡Este tutorial es para el diseño de #AI Chatbot en el marco del de Coze y HackerNoon! concurso de redacción #AI-chatbot En un mundo perfecto, su aplicación tendría todo para todos y sería capaz de ofrecer todas las funciones para todos los usuarios. Desafortunadamente, ninguna aplicación es tan poderosa como esa, por lo que los complementos son bastante importantes. Los complementos ayudan a cerrar la brecha entre su aplicación y el resto del ecosistema tecnológico al ampliar sin problemas la funcionalidad y la capacidad de sus aplicaciones. La mejor parte es que los complementos hacen esto sin afectar inherentemente el código fuente de su aplicación. Este tutorial le enseñará cómo crear complementos desde cero en Coze. Pero primero, intentemos entender qué son los complementos. ¿Qué es un complemento? Los complementos son complementos de software que mejoran las capacidades de su aplicación o programas sin reescribir ni cambiar el código original. Los complementos suelen lograr esto integrándose en la base de código de su aplicación a través de una interfaz de programación de aplicaciones (API) o cualquier otro punto de integración que ofrezca el programa principal. El proceso suele ser perfecto. Para usted, el desarrollador, los complementos le permiten brindar a sus usuarios más personalización, datos y funcionalidades que mejorarán su experiencia sin tener que invertir en nada. Para los usuarios, esto significa una mejor experiencia en la aplicación. ¿Qué es Coze? es una plataforma que permite a los usuarios crear, personalizar e implementar bots de IA utilizando un enfoque de poco código/sin código a través de plataformas sociales. Por lo tanto, está democratizando prácticamente todo el proceso de chatbot de IA para todos. La plataforma también viene con herramientas, complementos, modo multiagente y funciones de conocimiento y memoria que lo ayudan a personalizar y ampliar la funcionalidad de sus bots de IA. Coze Al igual que otras plataformas, Coze ofrece varios complementos oficiales diseñados para diversas industrias. Estos complementos, como GPT4V, CapCut, Doc Reader y X, satisfacen necesidades específicas en múltiples categorías, incluidas noticias y lectura, fotografía, estilo de vida, ciencia, educación y finanzas. Además, los usuarios pueden enviar complementos personalizados. En este tutorial, creará uno para , una plataforma de agregación de datos de criptomonedas que permite a los usuarios realizar un seguimiento de varias estadísticas de monedas, desde los precios de las criptomonedas hasta la capitalización de mercado y el volumen de operaciones. CoinGecko Consulta la para obtener más información sobre Coze. guía del usuario oficial de Coze ¿Cómo se crea un complemento de CoinGecko en Coze? En Coze, puedes crear complementos de varias formas. Algunas de estas formas son: Importar un servicio API existente. Importación de archivos JSON o YAML. A través del analizador de código. A través de la IDE Coze. Agregar herramientas a un complemento. En esta guía, explorará la para crear el complemento . Coze IDE es un entorno de desarrollo integrado basado en la web que le permite crear en Node.js o Python. ruta de Coze IDE CoinGecko Prerrequisitos Para seguir este tutorial, necesitarás lo siguiente: Una . cuenta de Coze Una cuenta de desarrollador de CoinGecko. Una cuenta gratuita será suficiente, ya que necesita acceso básico a su . API Creación de un complemento Coze a través del IDE de Coze Siga estos pasos para crear su complemento CoinGecko. Inicie sesión en y visite el espacio de su equipo dentro del panel del espacio de trabajo. Coze.com Haga clic en la pestaña Complementos y luego en Crear . También puede visitar la y crear complementos. complemento página de Desarrollo del agente Dale a tu complemento un nombre, una descripción y un ícono (opcional). Seleccione en el menú desplegable . Complemento de nube - Crear en Coze IDE Método de creación de la herramienta de complemento Seleccione como su lenguaje de elección en . Python el tiempo de ejecución del IDE Haga clic en para ser redirigido a la página del complemento para crear su herramienta. Confirmar Creación de una herramienta para su complemento Coze A continuación, debes crear tu herramienta de complemento. Haga clic en en la . Crear herramienta en IDE página Complemento Dale un nombre y una descripción a tu herramienta. Haga clic en para ser redirigido a la , donde puede codificar su herramienta. Confirmar página de Coze IDE Codificación del complemento Coze Haga clic en el en el a su izquierda para agregar dependencias. Aquí, debe instalar el paquete para que podamos enviar HTTP. icono + panel Paquetes de solicitudes Al instalar cualquier paquete allí podrá usarlo cualquier herramienta en su complemento. Visita el para obtener tu clave API de CoinGecko. panel de desarrolladores de CoinGecko En la pestaña Código, escribe tu código según la plantilla proporcionada por Coze. Es importante que no elimines ni modifiques el método del controlador, ya que esto provocaría un error. La URL base se obtuvo de los documentos de autenticación. from runtime import Args import requests API_KEY = "****" BASE_URL = "https://api.coingecko.com/api/v3" def get_coin_data(coin_id: str, currency: str = "usd", logger=None): endpoint = f"{BASE_URL}/coins/markets" params = { "vs_currency": currency, "ids": coin_id.lower(), # Convert to lowercase "x_cg_demo_api_key": API_KEY } try: response = requests.get(endpoint, params=params) response.raise_for_status() # Raise an exception for bad status codes data = response.json() if logger: logger.info(f"API Response: {data}") return data except requests.RequestException as e: if logger: logger.error(f"API Request failed: {str(e)}") return {"error": f"API request failed: {str(e)}"} def handler(args: Args) -> dict: args.logger.info(f"Received args: {args}") args.logger.info(f"Type of args.input: {type(args.input)}") args.logger.info(f"Content of args.input: {args.input}") # Handle CustomNamespace object if hasattr(args.input, 'coin_id') and hasattr(args.input, 'currency'): coin_id = getattr(args.input, 'coin_id', 'bitcoin') currency = getattr(args.input, 'currency', 'usd') else: return { "message": f"Error: Invalid input format. Expected CustomNamespace with coin_id and currency attributes. Input: {args.input}", "data": None } args.logger.info(f"Processed input - coin_id: {coin_id}, currency: {currency}") try: coin_data = get_coin_data(coin_id, currency, args.logger) if "error" in coin_data: return { "message": f"Error: {coin_data['error']}", "data": None } else: # Check if we got any data if not coin_data: return { "message": f"No data found for {coin_id}", "data": None } # Assuming the API returns a list with one item for the specified coin coin_info = coin_data[0] if coin_data else {} return { "message": f"Successfully retrieved data for {coin_id}", "data": { "name": coin_info.get("name"), "symbol": coin_info.get("symbol"), "current_price": coin_info.get("current_price"), "market_cap": coin_info.get("market_cap"), "price_change_24h": coin_info.get("price_change_24h") } } except Exception as e: args.logger.error(f"An error occurred: {str(e)}") return { "message": f"An error occurred while processing the request: {str(e)}", "data": None } Haga clic en la para agregar metadatos a la herramienta. pestaña Metadatos Haga clic en y para agregarlos como parámetros de entrada y salida a la herramienta API de CoinGecko. Estos son sus parámetros: Editar Agregar parámetros coin_id (cadena): el ID de la criptomoneda (por ejemplo, "bitcoin", "ethereum"). Parámetros de entrada: moneda (cadena): la moneda de destino para los datos del mercado (por ejemplo, "usd", "eur") Parámetros de entrada: mensaje (cadena): un mensaje que indica el estado de la solicitud. Parámetros de salida: datos (objeto): Dentro de este objeto de datos, utilice estos parámetros. Parámetros de salida: nombre (cadena): el nombre de la criptomoneda. Dentro de los parámetros de salida de datos: símbolo (cadena): el símbolo de la criptomoneda. Dentro de los parámetros de salida de datos: current_price (número): el precio actual en la moneda especificada. Dentro de los parámetros de salida de datos: market_cap (número): La capitalización de mercado en la moneda especificada. Dentro de los parámetros de salida de datos: price_change_24h (número): El cambio de precio en las últimas 24 horas Dentro de los parámetros de salida de datos: Los metadatos permiten que su herramienta Coze sepa qué esperar y extraer de los usuarios y cómo responderles. Prueba y publicación de su complemento Coze Ingrese su parámetro de entrada en la pestaña para probar y ejecutar su complemento. Código de prueba Haga clic en . Ejecutar Vea el para ver la respuesta de su herramienta. valor de salida Vea los registros en el para ver si fue exitoso o si hubo algún error. panel de la Consola Haga clic en para publicar su complemento si la prueba es exitosa. Publicar Marque en el cuadro de diálogo Declaración de recopilación de datos de privacidad, ya que nuestro complemento no recopila datos de los usuarios. Sin embargo, si su complemento requiere datos de los usuarios, marque . No Sí Haz clic en . Dirígete a la tienda y explora este . Publicar complemento de CoinGecko ¿Qué es un Plug-in? Los complementos son formas efectivas de integrar y ampliar las capacidades de sus aplicaciones sin cambiar el código fuente. Al aprovechar las características de los complementos de Coze, puede crear aplicaciones de IA y ampliar sus funciones mediante la integración con cualquiera de los complementos oficiales de Coze. ¿No encuentra el complemento que desea? Ahora puede crear fácilmente un complemento personalizado con cualquier API que elija. Esto facilita la mejora de la interacción con el usuario y la ampliación de las funciones de su aplicación. Obtenga más información sobre la herramienta explorando su . canal de YouTube Si has leído hasta aquí, ¡te lo agradezco! Puedes contactarme en , o iheifeanyi [at] Twitter LinkedIn gmail.com Por favor, dale me gusta o comenta. ¡Gracias! ❤️🚀🙏🏽