Cómo crear complementos desde cero en Coze: CoinGecko

Ps. ¡Este tutorial es para el diseño de #AI Chatbot en el marco del concurso de redacción #AI-chatbot de Coze y HackerNoon!

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?

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.

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 CoinGecko , 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.

Consulta la guía del usuario oficial de Coze para obtener más información sobre 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 ruta de Coze IDE para crear el complemento CoinGecko . Coze IDE es un entorno de desarrollo integrado basado en la web que le permite crear en Node.js o Python.

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.

1. Inicie sesión en Coze.com y visite el espacio de su equipo dentro del panel del espacio de trabajo.

2. Haga clic en la pestaña Complementos y luego en Crear complemento . También puede visitar la página de Desarrollo del agente y crear complementos.

3. Dale a tu complemento un nombre, una descripción y un ícono (opcional).

4. Seleccione Complemento de nube - Crear en Coze IDE en el menú desplegable Método de creación de la herramienta de complemento .

5. Seleccione Python como su lenguaje de elección en el tiempo de ejecución del IDE .

6. Haga clic en Confirmar para ser redirigido a la página del complemento para crear su herramienta.

   
   

   

   
   

   Creación de una herramienta para su complemento Coze

   A continuación, debes crear tu herramienta de complemento.

   
   

7. Haga clic en Crear herramienta en IDE en la página Complemento .

8. Dale un nombre y una descripción a tu herramienta.

9. Haga clic en Confirmar para ser redirigido a la página de Coze IDE , donde puede codificar su herramienta.

Codificación del complemento Coze

1. Haga clic en el icono + en el panel Paquetes a su izquierda para agregar dependencias. Aquí, debe instalar el paquete de solicitudes para que podamos enviar HTTP.

   

   
   

   Al instalar cualquier paquete allí podrá usarlo cualquier herramienta en su complemento.

   
   

2. Visita el panel de desarrolladores de CoinGecko para obtener tu clave API de CoinGecko.

3. 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 } 

4. Haga clic en la pestaña Metadatos para agregar metadatos a la herramienta.
5. Haga clic en Editar y Agregar parámetros para agregarlos como parámetros de entrada y salida a la herramienta API de CoinGecko. Estos son sus parámetros:

   • Parámetros de entrada: 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 salida: 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.

   • Dentro de los parámetros de salida de datos: 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

     
     

     

     
     

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

1. Ingrese su parámetro de entrada en la pestaña Código de prueba para probar y ejecutar su complemento.

2. Haga clic en Ejecutar .

   

   
   

3. Vea el valor de salida para ver la respuesta de su herramienta.

4. Vea los registros en el panel de la Consola para ver si fue exitoso o si hubo algún error.

5. Haga clic en Publicar para publicar su complemento si la prueba es exitosa.

6. Marque No 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 Sí .

   
   

   

   
   

   
   

7. Haz clic en Publicar . Dirígete a la tienda y explora este 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 Twitter , LinkedIn o iheifeanyi [at] gmail.com

   
   

   Por favor, dale me gusta o comenta. ¡Gracias! ❤️🚀🙏🏽