Merge pull request #16 from hanno-meister/feature/parallel-agent-v2

New Parallel Function Calling Agent with MCP support

Author: YoanSallami

README.md

@@ -61,6 +61,20 @@ Developping a successful LM application in a profesional context, beyond statele
 
 Synalinks can help you simplify these tasks by leveraging decade old practices in Deep Learning frameworks. We provide a comprehensive suite of tools and features designed to streamline the development process, making it easier to create, evaluate, train, document and deploy robust neuro-symbolic LMs applications.
 
+## What about other frameworks?
+
+<div align="center">
+
+| Framework | MCP | Graph DB | Logical Flow | Robust Branching | Parallel Function Calling | Ease of Use |
+| --- | --- | --- | --- | --- | --- | --- |
+| Synalinks | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | 😀 |
+| DSPy      | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No | 😢 |
+| AdalFlow  | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No | 😢 |
+| TextGrad  | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No | 😭 |
+| Trace     | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No | 😭 |
+
+</div>
+
 ## Install
 
 ```shell

coverage-badge.svg

@@ -0,0 +1,2 @@
+
+::: synalinks.src.modules.agents.function_calling_agent

docs/Synalinks API/Modules API/Agents Modules/FunctionCallingAgent module.md

@@ -1,4 +1,3 @@
 # Agent Modules
 
-- [ReACT module](ReACT Agent module.md)
-- [Parallel ReACT module](Parallel ReACT Agent module.md)
+- [FunctionCallingAgent module](FunctionCallingAgent module.md)

docs/Synalinks API/Modules API/Agents Modules/Parallel ReACT Agent module.md

@@ -5,6 +5,5 @@
 - [Not module](Not module.md)
 - [Generator module](Generator module.md)
 - [Decision module](Decision module.md)
-- [MultiDecision module](MultiDecision module.md)
 - [Action module](Action module.md)
 - [Branch module](Branch module.md)

docs/Synalinks API/Modules API/Agents Modules/ReACT Agent module.md

@@ -52,7 +52,6 @@ if __name__ == "__main__":
 - [Not module](Core Modules/Not module.md)
 - [Generator module](Core Modules/Generator module.md)
 - [Decision module](Core Modules/Decision module.md)
-- [MultiDecision module](Core Modules/MultiDecision module.md)
 - [Action module](Core Modules/Action module.md)
 - [Branch module](Core Modules/Branch module.md)
 
@@ -85,5 +84,4 @@ if __name__ == "__main__":
 
 ### Agents Modules
 
-- [ReACT Agent module](Agents Modules/ReACT Agent module.md)
-- [Parallel ReACT Agent module](Agents Modules/Parallel ReACT Agent module.md)
+- [FunctionCallingAgent module](Agents Modules/FunctionCallingAgent module.md)

docs/Synalinks API/Modules API/Agents Modules/index.md

@@ -0,0 +1,80 @@
+import synalinks
+import asyncio
+import litellm
+
+
+class Query(synalinks.DataModel):
+    query: str = synalinks.Field(
+        description="The user query",
+    )
+
+
+class NumericalFinalAnswer(synalinks.DataModel):
+    final_answer: float = synalinks.Field(
+        description="The correct final numerical answer",
+    )
+
+
+@synalinks.utils.register_synalinks_serializable()
+async def calculate(expression: str):
+    """Calculate the result of a mathematical expression.
+
+    Args:
+        expression (str): The mathematical expression to calculate, such as
+            '2 + 2'. The expression can contain numbers, operators (+, -, *, /),
+            parentheses, and spaces.
+    """
+    if not all(char in "0123456789+-*/(). " for char in expression):
+        return {
+            "result": None,
+            "log": (
+                    "Error: invalid characters in expression. "
+                    "The expression can only contain numbers, operators (+, -, *, /),"
+                    " parentheses, and spaces NOT letters."
+                ),
+        }
+    try:
+        # Evaluate the mathematical expression safely
+        result = round(float(eval(expression, {"__builtins__": None}, {})), 2)
+        return {
+            "result": result,
+            "log": "Successfully executed",
+        }
+    except Exception as e:
+        return {
+            "result": None,
+            "log": f"Error: {e}",
+        }
+
+
+async def main():
+    litellm._turn_on_debug()
+    language_model = synalinks.LanguageModel(model="ollama/mistral")
+
+    tools = [
+        synalinks.Tool(calculate),
+    ]
+
+    inputs = synalinks.Input(data_model=Query)
+    outputs = await synalinks.FunctionCallingAgent(
+        data_model=NumericalFinalAnswer,
+        tools=tools,
+        language_model=language_model,
+        max_iterations=5,
+        return_inputs_with_trajectory=True,
+        autonomous=True,
+    )(inputs)
+    agent = synalinks.Program(
+        inputs=inputs,
+        outputs=outputs,
+        name="math_agent",
+        description="A math agent",
+    )
+
+    input_query = Query(query="How much is 152648 + 485?")
+    response = await agent(input_query)
+
+    print(response.prettify_json())
+
+if __name__ == "__main__":
+    asyncio.run(main())