イージーエージェント：自然言語を用いたインテリジェントな自動エージェントの迅速な構築

Easy Agentsはオープンソースのフレームワークで、簡単な自然言語コマンドによってインテリジェントな自動化エージェントを素早く構築し、デプロイすることができるように設計されています。技術者でなくても簡単に複雑なワークフローを定義でき、手作業でコードを書く手間を減らすことができます。ユーザは自然言語でタスクを記述するだけで、フレームワークは自動的に対応する自動化エージェントを生成することができ、セキュリティ運用、カスタマーサポート、IT管理シナリオなどに適しています。Easy AgentsはFastAPIとMCP (Model Context Protocol)に基づいており、効率的なツール統合とデプロイ方法を提供します。公式ドキュメントでは、簡単なコマンドで複雑なタスクを自動化する方法の4つの例を提供しています。このプロジェクトは Kyle Polley によって GitHub で管理されており、コミュニティからのコードやフィードバックを歓迎しています。

機能一覧

• 複雑なコードなしに自然言語でエージェントの動作を定義することができます。
• インテグレーテッド エムシーピー プロトコルを使用して、外部ツールやAPIに簡単に接続できます。
• FastAPI エンドポイントと cron トリガーを提供し、エージェントのデプロイを簡素化します。
• プロジェクトの依存関係を管理し、一貫した環境を確保するためのuvツールが含まれています。
• プロキシ機能を拡張するためのカスタムMCPサーバーの作成をサポート。
• セキュリティ・アラート分析、レポート生成などのシナリオを示すサンプル・ワークフローを提供します。
• ユーザーが問題やコードの改善を提出できるオープンソースコミュニティサポート。

ヘルプの使用

設置プロセス

Easy Agents を使い始めるには、リポジトリをクローンし、環境を設定する必要があります。以下は詳細なインストール手順です：

1. クローン倉庫
   ターミナルで以下のコマンドを実行し、Easy Agentsリポジトリをローカルにクローンします：

   git clone https://github.com/kpolley/easy-agents.git
   cd easy-agents
   

2. 依存関係のインストール
   簡単なエージェントの使用 uv ツールを使って依存関係を管理します。Pythonと uvそして実行する：

   uv sync
   

   これにより、FastAPI や関連ライブラリなど、プロジェクトに必要なすべての依存パッケージが自動的にインストールされます。

3. 開発サーバーの起動
   インストールが完了したら、FastAPI 開発サーバーを起動します：

   uv run fastapi dev main.py
   

   サーバーが起動したら、ブラウザからアクセスできる。 http://localhost:8000 API エンドポイントを表示します。

4. 設定環境
   GitHubやSlackなどの外部ツールに接続する必要がある場合は、プロジェクトの設定ファイルでMCPサーバーのアドレスを設定する必要があります。以下を参照してください。 mcps/github_extended.py 例えば、カスタムのMCPサーバーを構成する場合。

プロキシの作成

新しいエージェントの作成は非常に簡単で、以下のステップを踏むだけです：

1. プロキシの動作の定義
   プロジェクトディレクトリの設定ファイルに、エージェントのタスクを自然言語で記述します。例

   你是一个负责调查安全警报的专家代理。任务步骤：
   1. 根据警报 ID 查询详细信息
   2. 深入分析警报内容
   3. 生成详细报告
   4. 如果警报有效，将报告发送到 Slack 的 #security-alerts 频道
   

   これらの命令は、フレームワークによって実行可能なワークフローに解析される。

2. MCPサーバーの指定
   エージェントがアクセスする必要がある MCP サーバーのアドレスを設定ファイルに指定します。例えば、GitHub API に接続するには、公式の GitHub MCP サーバーまたはカスタムサーバーを使用できます。
3. 配備エージェント
   エージェントは FastAPI エンドポイントまたは cron トリガーでデプロイできます。以下のコマンドを実行して、時間指定タスクを設定します：

   uv run python scripts/run_agent.py
   

   またはAPIコールを介してエージェントの実行をトリガする。

注目の機能操作

自然言語プログラミング

イージーエージェントのコア機能は、ユーザが自然言語で複雑なタスクを定義できるようにすることです。例えば、プロジェクトの週次レポートを生成するエージェントを作成します：

每周日，代理会检查 Linear 的任务和项目，生成团队项目进展报告，列出本周完成的任务和负责人。

フレームワークは自動的にコマンドを解析し、関連するAPI（Linear APIなど）を呼び出し、レポートを生成する。ユーザーはコードを書く必要はなく、要件を記述するだけでよい。

外部ツールの統合

Easy Agentsは、MCPプロトコルを介して外部ツールを簡単に統合できます。例えば、Slackに接続して通知を送信することができます：

1. 設定ファイルにSlack MCPサーバーのアドレスを追加する。
2. 例えば、"Send report to channel #team-updates "のように、エージェントコマンドに通知を送信するステップを含めます。
3. エージェントがデプロイされると、指定されたSlackチャンネルにレポートが自動的に送信されます。

MCPサーバーのカスタマイズ

デフォルトのツールではニーズに合わない場合は、カスタムのMCPサーバーを作成することができます。以下を参照してください。 mcps/github_extended.py以下の手順に従ってください：

1. MCPサーバー・ロジックを定義する新しいPythonファイルを作成します。
2. GitHub リポジトリのデータを取得するなど、外部 API とのやり取りが可能になります。
3. プロキシ設定でこのサーバーアドレスを参照する。
4. デプロイされると、エージェントはカスタムツールを呼び出すことができる。

デバッグと拡張

• テスト中にコンポーネントを調整するFastAPI サーバーは、エージェント実行の各ステップを記録するログを提供します。ユーザーは、ログからタスクの実行を確認できます。
• エクステンションユーザーは、プルリクエストを提出したり、コードを修正することで、機能を拡張することができます。例えば、他のツールをサポートするために新しいMCPサーバーを追加するなどです。

ほら

• ネットワーク接続が安定しており、MCPサーバーが外部APIにアクセスする必要があることを確認します。
• プローブ uv バージョンの互換性、最新版を推奨。
• コミュニティから提供された最新機能のために、リポジトリを定期的に更新する。

アプリケーションシナリオ

1. 安全保障の運用と保守（O&M）
   Easy Agentsは、セキュリティアラート処理の自動化に使用できます。エージェントは、アラートの照会、脅威の分析、レポートの生成、チームコミュニケーションツールへの結果の送信を行うことができ、手作業の時間を削減します。
2. カスタマーサポート
   エージェントは、顧客からの一般的な質問に自動的に応答し、サポートチケットを照合し、顧客サービスの効率を向上させるためにサマリーレポートを作成することができます。
3. ITマネジメント
   自動化されたサーバー監視、ログ分析、リソース割り当てのために。エージェントは、「サーバーのステータスをチェックして、毎日レポートを送信する」などの自然言語コマンドに基づいてタスクを実行することができます。
4. プロジェクト管理
   プロジェクトの週次進捗レポートを自動生成し、タスクの完了を分析し、チームに通知します。

品質保証

1. イージーエージェントはプログラミング経験のないユーザーにも適していますか？
   はい、イージーエージェントを使えば、ユーザーはプログラミングの知識を必要とせず、自然言語でタスクを定義することができます。技術者でなくてもすぐに始めることができます。
2. エージェントの機能を拡張するには？
   ユーザーは、カスタムのMCPサーバーを作成したり、コードを修正することで、機能を拡張することができます。参考文献 mcps/github_extended.py 例
3. エージェントを配備するにはどのような環境が必要ですか？
   Python、uvツール、インターネット接続が必要。LinuxまたはmacOSでの実行を推奨。
4. どのような外部ツールがサポートされていますか？
   GitHub、Slackなどのツールをサポートし、MCPプロトコルを介してAPIをサポートするあらゆるツールに拡張できる。