Merge pull request #43 from debuggerone/examples

added 7 more agents and examples and updated the EXAMPLE.md file

docs/EXAMPLES.md

@@ -119,4 +119,79 @@ Classifying item: Based on the following criteria 'Classify each item as either
 Received response for item: Based on the following criteria 'Classify each item as either healthy (true) or unhealthy (false)', classify the item 'Carrot' as true or false. -> True
 Original list: ['Apple', 'Chocolate', 'Carrot']
 Binary classified results: [{'item': "Based on the following criteria 'Classify each item as either healthy (true) or unhealthy (false)', classify the item 'Apple' as true or false.", 'classification': 'True'}, {'item': "Based on the following criteria 'Classify each item as either healthy (true) or unhealthy (false)', classify the item 'Chocolate' as true or false.", 'classification': "Chocolate can be classified as unhealthy (false) if it contains high levels of sugar and fat, such as most commercially available milk chocolates. However, dark chocolate with a high cocoa content (70% or more) has health benefits and can be considered healthy in moderation. \n\nWithout specific context, the classification can vary. Generally:\n\n- If we consider typical chocolate, it would be classified as unhealthy (false).\n- If it is high-quality dark chocolate and consumed in moderation, it could be classified as healthy (true).\n\nFor general classification, I would classify 'Chocolate' as unhealthy (false)."}, {'item': "Based on the following criteria 'Classify each item as either healthy (true) or unhealthy (false)', classify the item 'Carrot' as true or false.", 'classification': 'True'}]
+```# AgentM Examples (Continued)
+
+## Example 5: Project List
+
+Run the **project list** example to project items based on a rule:
+
+```bash
+python examples/project_list_example.py
+```
+
+### Sample Output:
+
+```bash
+Original list: ['Apple', 'Banana', 'Carrot']
+Projected results: [{'item': "Project the following item based on the rule 'Project these items as their vitamin content': Apple.", 'projection': "Apples are known for their vitamin content, particularly vitamin C. A medium-sized apple typically contains about 14% of the daily value of vitamin C. Additionally, apples provide small amounts of other vitamins such as vitamin A and some B vitamins (like B6 and riboflavin), but their overall vitamin content is modest compared to other fruits. \n\nTherefore, based on the rule 'Project these items as their vitamin content,' the projected vitamin content for an apple would primarily highlight its contribution of vitamin C."}, {'item': "Project the following item based on the rule 'Project these items as their vitamin content': Banana.", 'projection': "Bananas are known for their nutrient content, particularly their vitamins. Here's a projection of the vitamin content found in a banana:\n\n- **Vitamin B6**: Bananas are an excellent source of Vitamin B6, which plays a crucial role in metabolism and brain health.\n- **Vitamin C**: They contain a moderate amount of Vitamin C, which is important for immune function and skin health.\n- **Vitamin A**: Present in smaller amounts, Vitamin A supports vision and immune health.\n- **Folate (Vitamin B9)**: Bananas provide some folate, which is essential for cell division and DNA synthesis.\n\nIn summary, bananas are primarily valued for their high Vitamin B6 content, along with contributions of Vitamin C, Vitamin A, and Folate."}, {'item': "Project the following item based on the rule 'Project these items as their vitamin content': Carrot.", 'projection': 'Carrots are known for their high vitamin content, particularly vitamin A. Here’s the projected vitamin content based on that focus:\n\n- **Vitamin A**: Carrots are rich in beta-carotene, which the body converts into vitamin A. This vitamin is important for vision, immune function, and skin health.\n- **Vitamin K1**: Essential for blood clotting and bone health.\n- **Vitamin B6**: Important for metabolism and brain health.\n- **Vitamin C**: Contributes to immune function and skin health.\n\nOverall, carrots can be projected as a nutrient-dense food with a strong emphasis on vitamin A and a good mix of other vitamins.'}]
+```
+
+## Example 6: Generate Object
+
+Run the **generate object** example to create an object based on a description:
+
+```bash
+python examples/generate_object_example.py
+```
+
+### Sample Output:
+
+```bash
+Object description: A machine that can sort fruits.
+Generated object: {'object_description': 'A machine that can sort fruits.', 'generated_object': '**High-Level Design of a Fruit Sorting Machine**\n\n**Machine Overview:**\nThe Fruit Sorting Machine is an automated system designed to efficiently categorize and sort various types of fruit based on size, color, weight, and quality. The machine aims to streamline the sorting process, reduce manual labor, and enhance consistency in fruit processing.\n\n**Components:**\n\n1. **Fruit Input Hopper:**\n   - Description: A large funnel-shaped container where fruits are initially loaded.\n   - Features: Adjustable height, vibration mechanism to prevent jamming, and a safety cover.\n\n2. **Conveyor Belt System:**\n   - Description: A series of conveyor belts that transport fruits from the input hopper to the sorting area.\n   - Features: Adjustable speed settings, rubberized surface for grip, and incline/decline options for gravity-assisted sorting.\n\n3. **Image Recognition System:**\n   - Description: A series of high-resolution cameras positioned above the conveyor belt.\n   - Function: Capture real-time images of the fruits as they pass by for size, color, and quality analysis using advanced image processing software.\n\n4. **Weight Measurement Station:**\n   - Description: A designated area on the conveyor belt equipped with load cells.\n   - Function: Measure the weight of each fruit to sort them according to predefined weight categories.\n\n5. **Sorting Mechanism:**\n   - Description: A combination of pneumatic actuators and mechanical arms.\n   - Function: Based on data from image recognition and weight measurement, fruits are directed to specific sorting paths.\n   - Features: Quick-release mechanisms for rapid sorting and adjustable sorting paths for various fruit types.\n\n6. **Output Bins:**\n   - Description: Several storage bins placed at the end of the sorting path to collect sorted fruits.\n   - Function: Each bin is designated for a specific category based on size, weight, and quality.\n   - Features: Labeling system for easy identification and removable for cleaning and maintenance.\n\n7. **Control Panel:**\n   - Description: A user-friendly interface for operators to set sorting parameters, monitor performance, and troubleshoot.\n   - Features: Touchscreen display, emergency stop button, and connectivity for remote monitoring.\n\n8. **Power Supply System:**\n   - Description: A robust electrical system to power all components of the machine.\n   - Features: Energy-efficient motors and backup battery support to ensure continuous operation.\n\n9. **Support Frame:**\n   - Description: The structural framework supporting all components.\n   - Features: Adjustable height settings, made of durable materials (stainless steel/aluminum) to resist wear and corrosion.\n\n**Workflow Summary:**\n1. Fruits are loaded into the input hopper.\n2. The conveyor belt transports the fruits to the image recognition system, where they are scanned for size and color.\n3. Fruits then pass over the weight measurement station to determine their weight.\n4. The sorting mechanism utilizes data from the recognition and weighing systems to direct each fruit into the appropriate output bin.\n5. Sorted fruits collected in designated bins can then be packaged or processed further.\n\n**Additional Considerations:**\n- Potential integration with a data management system to log sorting data for future analysis.\n- Implementation of a cleaning system to ensure hygiene, especially for perishable fruits.\n- Safety features to protect operators, such as shielded moving parts and emergency stops.\n\nThis high-level design outlines the fundamental components and workflow of a fruit sorting machine that works efficiently, accurately, and safely, fulfilling the needs of agricultural and food processing industries.'}
+```
+
+## Example 7: Map List
+
+Run the **map list** example to apply transformations to list items:
+
+```bash
+python examples/map_list_example.py
+```
+
+### Sample Output:
+
+```bash
+Original list: ['Apple', 'Banana', 'Carrot']
+Transformed list: ['APPLE', 'BANANA', 'CARROT']
+```
+
+## Example 8: Reduce List
+
+Run the **reduce list** example to reduce items to achieve a specific goal:
+
+```bash
+python examples/reduce_list_example.py
+```
+
+### Sample Output:
+
+```bash
+Original list: ['Banana', 'Apple', 'Carrot']
+Reduced results: [{'item': "Reduce the item 'Banana' to achieve the goal: Reduce these items to a single word representing their nutritional value.", 'reduced_item': 'Fruit'}, {'item': "Reduce the item 'Apple' to achieve the goal: Reduce these items to a single word representing their nutritional value.", 'reduced_item': 'Fruit'}, {'item': "Reduce the item 'Carrot' to achieve the goal: Reduce these items to a single word representing their nutritional value.", 'reduced_item': 'Beta-carotene'}]
+```
+
+## Example 9: Summarize List
+
+Run the **summarize list** example to generate concise summaries:
+
+```bash
+python examples/summarize_list_example.py
+```
+
+### Sample Output:
+
+```bash
+Original list: ['The quick brown fox jumps over the lazy dog.', 'Python is a popular programming language.']
+Summarized results: [{'item': 'Summarize the following: The quick brown fox jumps over the lazy dog..', 'summary': 'A swift brown fox leaps over a sluggish dog.'}, {'item': 'Summarize the following: Python is a popular programming language..', 'summary': 'Python is a widely used programming language known for its simplicity and versatility.'}]
 ```

examples/classify_list_example.py

@@ -0,0 +1,14 @@
+import asyncio
+from core.classify_list_agent import ClassifyListAgent
+
+async def run_classify_list_example():
+    items_to_classify = ['Apple', 'Chocolate', 'Carrot']
+    classification_criteria = 'Classify each item as healthy or unhealthy snack'
+    agent = ClassifyListAgent(list_to_classify=items_to_classify, classification_criteria=classification_criteria)
+    classified_items = await agent.classify_list()
+
+    print("Original list:", items_to_classify)
+    print("Classified results:", classified_items)
+
+if __name__ == "__main__":
+    asyncio.run(run_classify_list_example())