ConnectOnion

ConnectOnionは、「単純なことは単純に、複雑なことは可能に」という哲学に基づいて構築された、強力かつシンプルなPython用AIエージェントフレームワークです。定型コードを大幅に削減することで、開発者は数日ではなく数分で機能的なAIエージェントをリリースできます。中心的なコンセプトは単純明快です。AIエージェントは、Markdownプロンプトとツールとして機能するPython関数を組み合わせることで作成されます。このアプローチにより、計算ツールを備えた便利なアシスタントをわずか8行のコードで作成できますが、これはLangChainのような他の人気フレームワークでは約50行を要する可能性のあるタスクです。

ConnectOnionの使い方

ConnectOnionの始め方は、迅速かつ直感的に設計されています。
1. インストール: まず、pip経由でフレームワークをインストールします: pip install connectonion。
2. プロジェクト作成: 組み込みのCLIを使用してco create my-agentで新しいプロジェクトをスキャフォールディングします。このコマンドは、サンプルエージェントファイル、APIキー用の環境ファイル、AIアシスタント用の完全なフレームワークドキュメントを含むプロジェクト構造を自動的に設定します。
3. コンポーネントの定義: Pythonスクリプトで、プロンプト（例：「あなたは親切なアシスタントです」）とエージェントのツールとして機能するPython関数（例：`calculate`関数）を定義します。
4. エージェントの作成: agent = Agent(prompt, tools=[your_function])でエージェントをインスタンス化します。
5. 対話: result = agent.input("42 * 17は？")のように.input()メソッドを呼び出してエージェントを使用します。
さらに高速なワークフローのために、ConnectOnionは「Vibe Coding」を推奨しています。完全なドキュメントをCursorのようなAIコーディングアシスタントに貼り付け、必要なエージェントを説明すると、AIが完全なコードを生成します。

ConnectOnionの主な機能

• ミニマリストな構文: コードの複雑さを最大85%削減し、わずか数行のコードでエージェントを作成できます。
• Markdown + 関数 = エージェント: プロンプトをMarkdownで記述し、ツールを標準のPython関数とする直感的なモデルです。
• 強力なCLI: プロジェクトの迅速なスキャフォールディング、環境管理、ベストプラクティスを組み込んだコマンドラインインターフェース（co）。
• Vibe Coding: CursorなどのAIアシスタントにフレームワークのドキュメントを提供し、完璧なConnectOnionコードを記述させる高速開発手法。
• 組み込みデバッグ: @xrayデコレータがリアルタイムの洞察、反復追跡、パフォーマンスメトリクスを提供し、エージェントの動作を正確に把握できます。
• 自動ロギング: すべてのエージェントの対話が自動的にログに記録され、監視とレビューが容易になります。
• ステートフルツール: シンプルなステートレス関数と、複雑なステートフルなクラスベースのツール（例：Webオートメーション用の`Browser`クラス）の両方をサポートします。
• 自動スキーマ生成: Pythonの型ヒントをOpenAI互換の関数スキーマに自動的に変換し、手動でのスキーマ記述を不要にします。

ConnectOnionの使用例

ConnectOnionは多用途であり、以下のような幅広いAIエージェントの構築に使用できます。
単純なタスクエージェント: 基本的な例で示されているような数学計算などの特定のタスク用のエージェントを作成します。
Webスクレイパーとリサーチャー: URLからコンテンツをスクレイピングし、リンクを抽出し、Webから情報を収集できるエージェントを構築します。CLIには`web-research`テンプレートが含まれています。
自動化ボット: Playwrightテンプレートを使用してWebオートメーション用のエージェントを開発します。これには、ブラウザの起動、ページの移動、フォームの入力、スクリーンショットの撮影などのための事前構築済みツールが含まれています。
Eメールアシスタント: 特定のトリガーや条件に基づいてEメール通知を送信できるエージェントを生成します。
カスタムAI生成エージェント: CLIのAI搭載カスタムテンプレート機能を使用して、目的のエージェント（例：「GitHubリポジトリの新しいissueを監視するエージェント」）を記述すると、CLIが完全なプロジェクトを生成します。

ConnectOnionの利点

ConnectOnionの主な利点は、その根本的なシンプルさとスピードです。複雑さを抽象化し、定型コードを排除することで、開発者はエージェントのコアロジックに集中できます。これにより、開発サイクルが大幅に短縮されます。このフレームワークは、初心者にも優しく（セットアップの複雑さゼロ）、本番環境対応のアプリケーションにも十分強力です。革新的な「Vibe Coding」アプローチは、最新のAIアシスタントの力を活用し、開発をさらに加速させます。組み込みのデバッグおよびロギングツールは、エージェントの動作に対するプロフェッショナルレベルの可視性と制御を提供します。

料金プラン

提供されたドキュメントに基づくと、ConnectOnionは無料のオープンソースPythonライブラリです。`pip`を使用してインストールされ、価格、プラン、または商用ライセンスに関する言及はありません。ユーザーはフレームワーク自体に関連するコストなしで、すぐに構築を開始できます。

よくある質問（FAQ）

ConnectOnionとは何ですか？

ConnectOnionは、AIエージェントを構築するためのミニマリストなPythonフレームワークです。その中心的な哲学は、開発プロセスを簡素化し、MarkdownプロンプトとPython関数をツールとして組み合わせることで、最小限の定型コードで強力なエージェントを作成できるようにすることです。

ConnectOnionは無料で使用できますか？

はい、ドキュメントによるとConnectOnionは無料のオープンソースライブラリです。Python Package Index (PyPI)から`pip install connectonion`を使用して直接インストールでき、費用や有料プランに関する言及はありません。

ConnectOnionは他のフレームワークと比較してどのようにコードを削減しますか？

ConnectOnionは、他のフレームワークで必要とされる複雑なセットアップを抽象化します。型ヒントからスキーマ生成を自動的に処理し、シンプルな`Agent`クラスを提供します。これにより、機能的なエージェントをわずか8行のコードで作成できます。これは、LangChainなどのフレームワークで同様のエージェントに約50行が必要なのと比較して、定型コードを85%削減したことになります。

「Vibe Coding」とは何ですか？

「Vibe Coding」は、ConnectOnionが推進する開発ワークフローです。完全なフレームワークドキュメントをAIコーディングアシスタント（Cursorなど）に提供することを含みます。その後、開発者は自然言語で目的のエージェントを記述し、AIアシスタントが完全で正しいConnectOnionコードを生成することで、非常に迅速なプロトタイピングと開発が可能になります。

ConnectOnionで構築したエージェントをデバッグするにはどうすればよいですか？

ConnectOnionには`@xray`という組み込みのデバッグツールが含まれています。このデコレータをツール関数に適用する（例：`@xray def my_tool(...)`）ことで、どのツールが呼び出されているか、ユーザーの元のタスク、現在の反復回数など、エージェントの実行に関する詳細なリアルタイムの洞察を得ることができます。

エージェントはどのようなツールを使用できますか？

エージェントは、任意のPython関数をツールとして使用できます。ConnectOnionは、クラスインスタンス全体をエージェントに渡すことでステートフルツールもサポートします。クラスインスタンスが提供されると、ConnectOnionは型ヒントを持つすべてのパブリックメソッドを自動的に検出し、エージェントのツールとして利用可能にします。これは、Webブラウザの自動化などの複雑なタスクに最適です。