P.S. このチュートリアルは、Coze と HackerNoon による の #AI Chatbot デザイン用です。 #AI-chatbot ライティング コンテスト 理想的な世界では、アプリケーションはすべてのユーザーにとってあらゆる機能を備え、すべてのユーザーにあらゆる機能を提供できるはずです。残念ながら、それほど強力なアプリケーションは存在しないため、プラグインは非常に重要です。 プラグインは、アプリケーションの機能と性能をシームレスに拡張することで、アプリケーションとその他の技術エコシステムとの間のギャップを埋めるのに役立ちます。プラグインの最も優れた点は、アプリケーションのソース コードに本質的に影響を与えることなくこれを実現できることです。このチュートリアルでは、Coze でプラグインをゼロから作成する方法を説明します。 しかし、まずはプラグインとは何かを理解してみましょう。 プラグインとは何ですか? プラグインは、元のコードを書き直したり変更したりせずに、アプリケーションやプログラムの機能を強化するソフトウェア アドオンです。プラグインは、多くの場合、アプリケーション プログラミング インターフェイス (API) またはコア プログラムが提供するその他の統合ポイントを介してアプリケーションのコードベースに統合することで、これを実現します。このプロセスは通常シームレスです。 開発者にとって、プラグインを使用すると、再投資することなく、より多くのカスタマイズ、データ、機能をユーザーに提供して、ユーザー エクスペリエンスを向上させることができます。ユーザーにとって、これはアプリ使用時のエクスペリエンスが向上することを意味します。 Cozeとは何ですか? 、ソーシャル プラットフォームを介してローコード/ノーコード アプローチを使用して AI ボットを構築、カスタマイズ、展開できるプラットフォームです。したがって、AI チャットボット プロセス全体をほぼすべての人に民主化しています。このプラットフォームには、AI ボットの機能をカスタマイズおよび拡張するのに役立つツール、プラグイン、マルチエージェント モード、知識とメモリ機能も付属しています。 Coze は 他のプラットフォームと同様に、Coze はさまざまな業界に合わせたさまざまな公式プラグインを提供しています。GPT4V、CapCut、Doc Reader、X などのこれらのプラグインは、ニュースと読書、写真、ライフスタイル、科学、教育、金融など、複数のカテゴリにわたる特定のニーズに応えます。 さらに、ユーザーはカスタム プラグインを送信できます。このチュートリアルでは、暗号通貨の価格から時価総額、取引量まで、さまざまなコインの統計情報をユーザーが追跡できる暗号通貨データ アグリゲーター プラットフォームである 用のプラグインを構築します。 CoinGecko Coze の詳細については、 をご覧ください。 公式の Coze ユーザー ガイド Coze で CoinGecko プラグインを構築するにはどうすればよいでしょうか? Coze では、さまざまな方法でプラグインを構築できます。その方法のいくつかを以下に示します。 既存の API サービスをインポートします。 JSON または YAML ファイルをインポートします。 コードパーサー経由。 Coze IDE 経由。 プラグインにツールを追加します。 このガイドでは、 プラグインを構築するための について説明します。Coze IDE は、Node.js または Python で構築できる Web ベースの統合開発環境です。 CoinGecko Coze IDE ルート 前提条件 このチュートリアルを実行するには、次のものが必要です。 。 Cozeのアカウント CoinGecko 開発者アカウント への基本的なアクセスが必要なので、無料アカウントで十分です。 。API Coze IDE 経由で Coze プラグインを構築する CoinGecko プラグインを構築するには、次の手順に従ってください。 にログインし、ワークスペース パネル内のチーム スペースにアクセスします。 Coze.com 「プラグイン」タブをクリックし、 作成」をクリックします。または、 にアクセスしてプラグインを作成することもできます。 「プラグインの エージェントの開発ページ プラグインに名前、説明、アイコン（オプション）を入力します。 ドロップダウンで、 を選択します。 プラグイン ツールの作成方法 Coze IDE で [クラウド プラグイン - 作成] で、選択言語として 選択します。 IDE ランタイム Python を をクリックすると、プラグイン ページにリダイレクトされ、ツールが作成されます。 「確認」 Coze プラグイン用のツールの構築 次に、プラグイン ツールを作成する必要があります。 で クリックします。 プラグイン ページ IDE でツールを作成を ツールに名前と説明を付けます。 をクリックすると、 にリダイレクトされ、ツールをコーディングできるようになります。 「確認」 Coze IDE ページ Coze プラグインのコーディング 依存関係を追加するには、左側の の をクリックします。ここでは、HTTP を送信できるように、 パッケージをインストールする必要があります。 パッケージ パネル + アイコン リクエスト そこにパッケージをインストールすると、プラグイン内の任意のツールで使用できるようになります。 にアクセスして、CoinGecko API キーを取得します。 CoinGecko 開発者ダッシュボード コード タブ内で、Coze が提供するテンプレートに基づいてコードを記述します。ハンドラー メソッドを削除または変更しないことが重要です。削除または変更すると失敗の原因になります。ベース URL は認証ドキュメントから取得されました。 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 } ツールのメタデータを追加するには、 をクリックします。 [メタデータ] タブ および をクリックして、これらを CoinGecko API ツールの入力パラメータと出力パラメータとして追加します。パラメータは次のとおりです。 「編集」 「パラメータの追加」 coin_id (文字列): 暗号通貨の ID (例: "bitcoin"、"ethereum")。 入力パラメータ: 通貨 (文字列): 市場データの対象通貨 (例: "usd"、"eur") 入力パラメータ: message (文字列): リクエストのステータスを示すメッセージ。 出力パラメータ: データ (オブジェクト): このデータ オブジェクト内では、これらのパラメータを使用します。 出力パラメータ: name (文字列): 暗号通貨の名前。 データ出力パラメータ内: symbol (文字列): 暗号通貨のシンボル。 データ出力パラメータ内: current_price (数値): 指定された通貨での現在の価格。 データ出力パラメータ内: market_cap (数値): 指定された通貨での時価総額。 データ出力パラメータ内: price_change_24h (数値): 過去24時間の価格変動 データ出力パラメータ内: メタデータにより、Coze ツールはユーザーから何を期待して抽出するか、またユーザーにどのように答えるかを把握できるようになります。 Coze プラグインのテストと公開 テストするには、 タブで入力パラメータを入力し、プラグインを実行します。 「テスト コード」 をクリックします。 [実行] ツールの応答を表示するには、 を表示します。 出力値 でログを表示して、成功したかエラーがあったかを確認します。 コンソール パネル テストが成功した場合は、 をクリックしてプラグインを公開します。 「公開」 当社のプラグインはユーザー データを収集しないため、[プライバシー収集ステートメント] ダイアログ ボックスで [ をオンにします。ただし、プラグインでユーザー データが必要な場合は、 をオンにします。 いいえ] [はい] をクリックします。ストアにアクセスして、この を調べてください。 「公開」 CoinGecko プラグイン プラグインとは何ですか? プラグインは、ソース コードを変更せずにアプリケーションの機能を統合および拡張する効果的な方法です。Coze プラグインの機能を活用することで、Coze の公式プラグインのいずれかと統合して AI アプリケーションを構築し、その機能を拡張できます。 必要なプラグインが見つかりませんか? 任意の API を選択して、カスタム プラグインを簡単に作成できるようになりました。これにより、ユーザー エンゲージメントを強化し、アプリケーションの機能を簡単に拡張できます。YouTube でツールの詳細をご覧ください 。 ここまで読んでくださった方、ありがとうございます！ 、 、iheifeanyi [at] で私に連絡を取ることができます。 Twitter LinkedIn gmail.com ぜひ「いいね！」やコメントをお願いします。ありがとうございます！❤️🚀🙏🏽
