diff --git a/.gitignore b/.gitignore index 9cd448c7..89ff1d49 100644 --- a/.gitignore +++ b/.gitignore @@ -72,6 +72,8 @@ docs/_build/ .scrapy profile_default/ ipython_config.py +development/.buildinfo +development/.doctrees/ # OS generated files .DS_Store diff --git a/development/_components/llm_config_tabs.html b/development/_components/llm_config_tabs.html index e6f61f56..7b5f427a 100644 --- a/development/_components/llm_config_tabs.html +++ b/development/_components/llm_config_tabs.html @@ -184,7 +184,7 @@ Release Notes
  • - Adapters + Adapters
  • Ecosystem @@ -291,7 +291,7 @@ Release Notes
  • - Adapters + Adapters
  • Ecosystem diff --git a/development/_downloads/f19b8bcca917257b409d935580c6e8a9/constraints.txt b/development/_downloads/f19b8bcca917257b409d935580c6e8a9/constraints.txt index 91489e4f..1bfe5783 100644 --- a/development/_downloads/f19b8bcca917257b409d935580c6e8a9/constraints.txt +++ b/development/_downloads/f19b8bcca917257b409d935580c6e8a9/constraints.txt @@ -10,7 +10,7 @@ autogen-ext==0.7.4 autogen-agentchat==0.7.4 # LangGraph adapter -langgraph==0.6.5 +langgraph==0.6.11 langchain-core==0.3.75 langchain-openai==0.3.30 langchain-ollama==0.3.6 diff --git a/development/_sources/adapters/autogen.rst.txt b/development/_sources/adapters/autogen.rst.txt deleted file mode 100644 index 0807aa1c..00000000 --- a/development/_sources/adapters/autogen.rst.txt +++ /dev/null @@ -1,61 +0,0 @@ -.. _autogenadapter: - -============================= -Agent Spec Adapters - AutoGen -============================= - - -.. figure:: ../_static/icons/autogen-adapter.jpg - :align: center - :scale: 20% - :alt: Agent Spec adapter for AutoGen - - ↑ With the **Agent Spec adapter for AutoGen**, you can easily import agents from external frameworks using Agent Spec and run them with AutoGen. - - -*Microsoft AutoGen supports the development of multi-agent conversational systems, -allowing agents to communicate and collaborate to solve tasks.* - - -Get started -=========== - -To get started, set up your Python environment (Python 3.10 to 3.12 required), -and then install the PyAgentSpec package with the AutoGen extension. - - -.. code-block:: bash - - python -m venv .venv - source .venv/bin/activate # On Windows: .venv\Scripts\activate - pip install "pyagentspec[autogen]" - - -You are now ready to use the adapter: - -- Run Agent Spec configurations with AutoGen (see more details :ref:`below `) -- Convert AutoGen agents to Agent Spec (see more details :ref:`below `) - - - -.. _spectoautogen: - -Run Agent Spec configurations with AutoGen -========================================== - - -.. literalinclude:: ../code_examples/adapter_autogen_quickstart.py - :language: python - :start-after: .. start-agentspec_to_runtime - :end-before: .. end-agentspec_to_runtime - - -.. _autogentospec: - -Convert AutoGen agents to Agent Spec -==================================== - -.. literalinclude:: ../code_examples/adapter_autogen_quickstart.py - :language: python - :start-after: .. start-runtime_to_agentspec - :end-before: .. end-runtime_to_agentspec diff --git a/development/_sources/adapters/autogen/autogen_to_spec.rst.txt b/development/_sources/adapters/autogen/autogen_to_spec.rst.txt new file mode 100644 index 00000000..991553e1 --- /dev/null +++ b/development/_sources/adapters/autogen/autogen_to_spec.rst.txt @@ -0,0 +1,12 @@ + +.. _autogentospec: + +Convert AutoGen agents to Agent Spec +==================================== + +This usage example showcases how an AutoGen Agent can be converted into an Agent Spec configuration in JSON format. + +.. literalinclude:: ../../code_examples/adapter_autogen_quickstart.py + :language: python + :start-after: .. start-runtime_to_agentspec + :end-before: .. end-runtime_to_agentspec diff --git a/development/_sources/adapters/autogen/index.rst.txt b/development/_sources/adapters/autogen/index.rst.txt new file mode 100644 index 00000000..fbad985c --- /dev/null +++ b/development/_sources/adapters/autogen/index.rst.txt @@ -0,0 +1,43 @@ +.. _autogenadapter: + +============================= +Agent Spec Adapters - AutoGen +============================= + + +.. figure:: ../../_static/icons/autogen-adapter.jpg + :align: center + :scale: 20% + :alt: Agent Spec adapter for AutoGen + + ↑ With the **Agent Spec adapter for AutoGen**, you can easily import agents from external frameworks using Agent Spec and run them with AutoGen. + + +*Microsoft AutoGen supports the development of multi-agent conversational systems, +allowing agents to communicate and collaborate to solve tasks.* + + +Get started +=========== + +To get started, set up your Python environment (Python 3.10 to 3.12 required), +and then install the PyAgentSpec package with the AutoGen extension. + + +.. code-block:: bash + + python -m venv .venv + source .venv/bin/activate # On Windows: .venv\Scripts\activate + pip install "pyagentspec[autogen]" + + +Usage Examples +============== + +You are now ready to use the adapter to: + +.. toctree:: + :maxdepth: 1 + + Run Agent Spec configurations with AutoGen + Convert AutoGen agents to Agent Spec diff --git a/development/_sources/adapters/autogen/spec_to_autogen.rst.txt b/development/_sources/adapters/autogen/spec_to_autogen.rst.txt new file mode 100644 index 00000000..4e12b749 --- /dev/null +++ b/development/_sources/adapters/autogen/spec_to_autogen.rst.txt @@ -0,0 +1,12 @@ +.. _spectoautogen: + +Run Agent Spec configurations with AutoGen +========================================== + +This usage example showcases the creation of a simple Agent Spec Agent, subsequently serialized into JSON and converted into an AutoGen +assistant. Also includes mapping of a `ServerTool` and execution of the conversation. + +.. literalinclude:: ../../code_examples/adapter_autogen_quickstart.py + :language: python + :start-after: .. start-agentspec_to_runtime + :end-before: .. end-agentspec_to_runtime diff --git a/development/_sources/adapters/langgraph.rst.txt b/development/_sources/adapters/langgraph.rst.txt deleted file mode 100644 index 7ad1cfe9..00000000 --- a/development/_sources/adapters/langgraph.rst.txt +++ /dev/null @@ -1,60 +0,0 @@ -.. _langgraphadapter: - -=============================== -Agent Spec Adapters - LangGraph -=============================== - - -.. figure:: ../_static/icons/langgraph-adapter.jpg - :align: center - :scale: 18% - :alt: Agent Spec adapter for LangGraph - - ↑ With the **Agent Spec adapter for LangGraph**, you can easily import agents from external frameworks using Agent Spec and run them with LangGraph. - - -*LangGraph facilitates the creation and management of long-running, stateful agents -with durable execution and human-in-the-loop capabilities.* - - -Get started -=========== - -To get started, set up your Python environment (Python 3.10 or newer required), -and then install the PyAgentSpec package with the LangGraph extension. - - -.. code-block:: bash - - python -m venv .venv - source .venv/bin/activate # On Windows: .venv\Scripts\activate - pip install "pyagentspec[langgraph]" - - -You are now ready to use the adapter: - -- Run Agent Spec configurations with LangGraph (see more details :ref:`below `) -- Convert LangGraph agents to Agent Spec (see more details :ref:`below `) - - -.. _spectolanggraph: - -Run Agent Spec configurations with LangGraph -============================================ - - -.. literalinclude:: ../code_examples/adapter_langgraph_quickstart.py - :language: python - :start-after: .. start-agentspec_to_runtime - :end-before: .. end-agentspec_to_runtime - - -.. _langgraphtospec: - -Convert LangGraph agents to Agent Spec -====================================== - -.. literalinclude:: ../code_examples/adapter_langgraph_quickstart.py - :language: python - :start-after: .. start-runtime_to_agentspec - :end-before: .. end-runtime_to_agentspec diff --git a/development/_sources/adapters/langgraph/index.rst.txt b/development/_sources/adapters/langgraph/index.rst.txt new file mode 100644 index 00000000..e0955df8 --- /dev/null +++ b/development/_sources/adapters/langgraph/index.rst.txt @@ -0,0 +1,44 @@ +.. _langgraphadapter: + +=============================== +Agent Spec Adapters - LangGraph +=============================== + + +.. figure:: ../../_static/icons/langgraph-adapter.jpg + :align: center + :scale: 18% + :alt: Agent Spec adapter for LangGraph + + ↑ With the **Agent Spec adapter for LangGraph**, you can easily import agents from external frameworks using Agent Spec and run them with LangGraph. + + +*LangGraph facilitates the creation and management of long-running, stateful agents +with durable execution and human-in-the-loop capabilities.* + + +Get started +=========== + +To get started, set up your Python environment (Python 3.10 or newer required), +and then install the PyAgentSpec package with the LangGraph extension. + + +.. code-block:: bash + + python -m venv .venv + source .venv/bin/activate # On Windows: .venv\Scripts\activate + pip install "pyagentspec[langgraph]" + + + +Usage Examples +============== + +You are now ready to use the adapter to: + +.. toctree:: + :maxdepth: 1 + + Run Agent Spec configurations with LangGraph + Convert LangGraph agents to Agent Spec diff --git a/development/_sources/adapters/langgraph/langgraph_to_spec.rst.txt b/development/_sources/adapters/langgraph/langgraph_to_spec.rst.txt new file mode 100644 index 00000000..35d5c3df --- /dev/null +++ b/development/_sources/adapters/langgraph/langgraph_to_spec.rst.txt @@ -0,0 +1,11 @@ +.. _langgraphtospec: + +Convert LangGraph agents to Agent Spec +====================================== + +This usage example showcases how a LangGraph Agent can be converted into an Agent Spec configuration in JSON format. + +.. literalinclude:: ../../code_examples/adapter_langgraph_quickstart.py + :language: python + :start-after: .. start-runtime_to_agentspec + :end-before: .. end-runtime_to_agentspec diff --git a/development/_sources/adapters/langgraph/spec_to_langgraph.rst.txt b/development/_sources/adapters/langgraph/spec_to_langgraph.rst.txt new file mode 100644 index 00000000..663351e1 --- /dev/null +++ b/development/_sources/adapters/langgraph/spec_to_langgraph.rst.txt @@ -0,0 +1,12 @@ +.. _spectolanggraph: + +Run Agent Spec configurations with LangGraph +============================================ + +This usage example showcases the creation of a simple Agent Spec Agent, subsequently serialized into JSON and converted into a LangGraph +assistant. Also includes mapping of a `ServerTool` and execution of the conversation. + +.. literalinclude:: ../../code_examples/adapter_langgraph_quickstart.py + :language: python + :start-after: .. start-agentspec_to_runtime + :end-before: .. end-agentspec_to_runtime diff --git a/development/_sources/adapters/wayflow.rst.txt b/development/_sources/adapters/wayflow/index.rst.txt similarity index 50% rename from development/_sources/adapters/wayflow.rst.txt rename to development/_sources/adapters/wayflow/index.rst.txt index 670482bc..b3c92abc 100644 --- a/development/_sources/adapters/wayflow.rst.txt +++ b/development/_sources/adapters/wayflow/index.rst.txt @@ -5,7 +5,7 @@ Agent Spec Adapters - WayFlow ============================= -.. figure:: ../_static/icons/wayflow-adapter.jpg +.. figure:: ../../_static/icons/wayflow-adapter.jpg :align: center :scale: 18% :alt: Agent Spec adapter for WayFlow @@ -31,31 +31,13 @@ and then install the PyAgentSpec package as well as WayFlowCore. pip install pyagentspec wayflowcore -You are now ready to use the adapter: +Usage Examples +============== -- Run Agent Spec configurations with WayFlow (see more details :ref:`below `) -- Convert WayFlow agents to Agent Spec (see more details :ref:`below `) +You are now ready to use the adapter to: +.. toctree:: + :maxdepth: 1 - -.. _spectowayflow: - -Run Agent Spec configurations with WayFlow -========================================== - - -.. literalinclude:: ../code_examples/adapter_wayflow_quickstart.py - :language: python - :start-after: .. start-agentspec_to_runtime - :end-before: .. end-agentspec_to_runtime - - -.. _wayflowtospec: - -Convert WayFlow agents to Agent Spec -==================================== - -.. literalinclude:: ../code_examples/adapter_wayflow_quickstart.py - :language: python - :start-after: .. start-runtime_to_agentspec - :end-before: .. end-runtime_to_agentspec + Run Agent Spec configurations with WayFlow + Convert WayFlow agents to Agent Spec diff --git a/development/_sources/adapters/wayflow/spec_to_wayflow.rst.txt b/development/_sources/adapters/wayflow/spec_to_wayflow.rst.txt new file mode 100644 index 00000000..0c119624 --- /dev/null +++ b/development/_sources/adapters/wayflow/spec_to_wayflow.rst.txt @@ -0,0 +1,12 @@ +.. _spectowayflow: + +Run Agent Spec configurations with WayFlow +========================================== + +This usage example showcases the creation of a simple Agent Spec Agent, subsequently serialized into JSON and converted into a WayFlow +assistant. Also includes mapping of a `ServerTool` and execution of the conversation. + +.. literalinclude:: ../../code_examples/adapter_wayflow_quickstart.py + :language: python + :start-after: .. start-agentspec_to_runtime + :end-before: .. end-agentspec_to_runtime diff --git a/development/_sources/adapters/wayflow/wayflow_to_spec.rst.txt b/development/_sources/adapters/wayflow/wayflow_to_spec.rst.txt new file mode 100644 index 00000000..a2b61354 --- /dev/null +++ b/development/_sources/adapters/wayflow/wayflow_to_spec.rst.txt @@ -0,0 +1,11 @@ +.. _wayflowtospec: + +Convert WayFlow agents to Agent Spec +==================================== + +This usage example shows how a WayFlow Agent can be converted into an Agent Spec JSON format. + +.. literalinclude:: ../../code_examples/adapter_wayflow_quickstart.py + :language: python + :start-after: .. start-runtime_to_agentspec + :end-before: .. end-runtime_to_agentspec diff --git a/development/_sources/agentspec/language_spec_nightly.rst.txt b/development/_sources/agentspec/language_spec_nightly.rst.txt index e7762245..d8bd77c9 100644 --- a/development/_sources/agentspec/language_spec_nightly.rst.txt +++ b/development/_sources/agentspec/language_spec_nightly.rst.txt @@ -836,7 +836,7 @@ the correct built-in tool. url: str http_method: str api_spec_uri: Optional[str] - data: Dict[str, Any] + data: Any query_params: Dict[str, Any] headers: Dict[str, Any] sensitive_headers: SensitiveField[Dict[str, Any]] @@ -855,6 +855,7 @@ code from the agent representation. The representation contains a complete descr of the tool—its attributes, inputs, outputs, and related metadata—but does not embed executable code. +.. _remotetools: Remote Tools ^^^^^^^^^^^^ @@ -873,8 +874,11 @@ in the right manner. Note that, similarly to the APINode, we allow users to use placeholders (as described in section 5.3.4) in all the string attributes of the RemoteTool (i.e., url, http_method, api_spec_uri, and in the dict values -of data, query_params, headers, and sensitive_headers). - +of data, query_params, headers, and sensitive_headers). The ``data`` parameter in +``RemoteTool`` is what ends up in the body of the request. +If ``data`` is specified as a string, the runtime must encode and pass it as the body of the HTTP request, +otherwise the value of ``data`` should be JSON serializable and runtimes are +expected to dump it when adding it in the body of the HTTP request. MCP Tools ^^^^^^^^^ @@ -1495,8 +1499,8 @@ A more detailed description of each node follows. - No - null * - data - - The data to send to this API call. Allows placeholders in dict values, which can define inputs - - object[str, any] + - The data to send to this API call. Behaves the same way as the ``data`` parameter in :ref:`RemoteTool `. + - any - No - {} * - query_params diff --git a/development/_sources/changelog.rst.txt b/development/_sources/changelog.rst.txt index c29573c1..57ee6cd6 100644 --- a/development/_sources/changelog.rst.txt +++ b/development/_sources/changelog.rst.txt @@ -7,6 +7,12 @@ Agent Spec |release| New features ^^^^^^^^^^^^ +* **MCP tools support in LangGraph adapter:** + + The LangGraph adapter now supports Model Context Protocol (MCP) tools. + + To use this, install the optional extra ``pyagentspec[langgraph_mcp]`` and invoke the loaded graph/agent asynchronously via ``.ainvoke`` within an async context. + * **Added LangGraph adapter to pyagentspec:** The LangGraph adapter is now available as part of ``pyagentspec``. @@ -92,6 +98,11 @@ New features Improvements ^^^^^^^^^^^^ +* **Extended functionality for data parameter** + + Extended the data parameter in ``RemoteTool`` and ``ApiNode`` from only being a dictionary to any JSON serializable object (including nested objects). + Also improved template rendering in the ``RemoteTool`` and ``ApiNode`` for PyAgentSpec adapters. + * **Python 3.14 support** Introduced support for Python version 3.14. diff --git a/development/_sources/docs_home.rst.txt b/development/_sources/docs_home.rst.txt index e19eb1fd..5ac651e9 100644 --- a/development/_sources/docs_home.rst.txt +++ b/development/_sources/docs_home.rst.txt @@ -114,13 +114,13 @@ Agent Spec is developed jointly between Oracle Cloud Infrastructure and Oracle L .. toctree:: - :maxdepth: 1 + :maxdepth: 2 :caption: Adapters :hidden: - LangGraph - WayFlow - AutoGen + LangGraph + WayFlow + AutoGen .. toctree:: diff --git a/development/adapters/autogen/autogen_to_spec.html b/development/adapters/autogen/autogen_to_spec.html new file mode 100644 index 00000000..c32ba288 --- /dev/null +++ b/development/adapters/autogen/autogen_to_spec.html @@ -0,0 +1,584 @@ + + + + + + + + + + + + + Convert AutoGen agents to Agent Spec — PyAgentSpec 26.1.0.dev0 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + + + +
    + + + Ctrl+K +
    +     + +
    + +
    + + +
    +
    + + + +
    + +
    + + + + + +
    + +
    +
    + +
    + +
    +
    + +
    + +
    + +
    + +
    +
    + +
    + + +
    + +
    + + + +
    + + +
    + +
    + +
      +
    • + + + + + + + + + Agent Spec GitHub repository +
      • +
    + +
    + +
    + + +
    + + +
    + + + +
    + +
    + + +
    +
    + + + + +
    + + + +
    + + +
    + + + +
    +
    + + +
    + + + +
    + +
    + +
    + +
      +
    • + + + + + + + + + Agent Spec GitHub repository +
      • +
    + +
    + +
    + +
    +
    +
    +
    + + +
    +
    +
    +
    +
    + + +
    + +
    + + +
    +
    + +
    +
    + +
    + +
    + + +
    + +
    + + +
    +
    + + + + + +
    + +
    +

    Convert AutoGen agents to Agent Spec#

    +

    This usage example showcases how an AutoGen Agent can be converted into an Agent Spec configuration in JSON format.

    +
    # Create an AutoGen Agent
+import os
+os.environ["OPENAI_API_KEY"] = "YOUR_API_KEY"
+from autogen_agentchat.agents import AssistantAgent
+from autogen_ext.models.openai import OpenAIChatCompletionClient
+
+async def add_tool(a: int, b: int) -> int:
+    """Adds a to b and returns the result"""
+    return a + b
+
+autogen_tools = {"add_tool": add_tool}
+
+model_client = OpenAIChatCompletionClient(
+    model="gpt-4.1",
+)
+
+autogen_agent = AssistantAgent(
+    name="assistant",
+    model_client=model_client,
+    tools=list(autogen_tools.values()),
+    system_message="Use tools to solve tasks, and reformulate the answers that you get.",
+    reflect_on_tool_use=True,
+)
+
+# Convert to Agent Spec
+from pyagentspec.adapters.autogen import AgentSpecExporter
+
+agentspec_config = AgentSpecExporter().to_json(autogen_agent)
+
    +
    +
    + + +
    + + + + + +
    + + + + +
    +
    + +
    + +
    +
    +
    + + + + + +
    +
    + +
    + +
    + +

    + + © Copyright 2025, Oracle and/or its affiliates.. +
    + +

    +
    + +
    + +

    + Created using Sphinx 6.1.0. +
    +

    +
    + +
    + + + +
    + +
    +

    + + Built with the PyData Sphinx Theme 0.16.1. +

    + +
    + +
    + +
    + + \ No newline at end of file diff --git a/development/adapters/autogen/index.html b/development/adapters/autogen/index.html new file mode 100644 index 00000000..1a1bd4e9 --- /dev/null +++ b/development/adapters/autogen/index.html @@ -0,0 +1,601 @@ + + + + + + + + + + + + + Agent Spec Adapters - AutoGen — PyAgentSpec 26.1.0.dev0 documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + + + +
    + + + Ctrl+K +
    +     + +
    + +
    + + +
    +
    + + + +
    + +
    + + + + + +
    + +
    +
    + +
    + +
    +
    + +
    + +
    + +
    + +
    +
    + +
    + + +
    + +
    + + + +
    + + +
    + +
    + +
      +
    • + + + + + + + + + Agent Spec GitHub repository +
      • +
    + +
    + +
    + + +
    + + +
    + + + + + +
    + +
    + + +
    +
    + + + + +
    + + + +
    + + +
    + + + +
    +
    + + +
    + + + +
    + +
    + +
    + +
      +
    • + + + + + + + + + Agent Spec GitHub repository +
      • +
    + +
    + +
    + +
    +
    +
    +
    + + +
    +
    +
    +
    +
    + + +
    + +
    + + +
    +
    + +
    +
    + +
    + +
    + + +
    + +
    + + +
    +
    + + + + + +
    + +
    +

    Agent Spec Adapters - AutoGen#

    +
    +Agent Spec adapter for AutoGen +
    +

    ↑ With the Agent Spec adapter for AutoGen, you can easily import agents from external frameworks using Agent Spec and run them with AutoGen.#

    +
    +
    +

    Microsoft AutoGen supports the development of multi-agent conversational systems, +allowing agents to communicate and collaborate to solve tasks.

    +
    +

    Get started#

    +

    To get started, set up your Python environment (Python 3.10 to 3.12 required), +and then install the PyAgentSpec package with the AutoGen extension.

    +
    python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+pip install "pyagentspec[autogen]"
+
    +
    +
    +
    +

    Usage Examples#

    +

    You are now ready to use the adapter to:

    +
    + +
    +
    +
    + + +
    + + + + + +
    + + + + +
    + + +
    +
    + On this page +
    +
    + +
    + + +
    +
    + +
    + +
    +
    +
    + + + + + +
    +
    + +
    + +
    + +

    + + © Copyright 2025, Oracle and/or its affiliates.. +
    + +

    +
    + +
    + +

    + Created using Sphinx 6.1.0. +
    +

    +
    + +
    + + + +
    + +
    +

    + + Built with the PyData Sphinx Theme 0.16.1. +

    + +
    + +
    + +
    + + \ No newline at end of file diff --git a/development/adapters/autogen.html b/development/adapters/autogen/spec_to_autogen.html similarity index 51% rename from development/adapters/autogen.html rename to development/adapters/autogen/spec_to_autogen.html index 1310f7dc..88f49316 100644 --- a/development/adapters/autogen.html +++ b/development/adapters/autogen/spec_to_autogen.html @@ -10,7 +10,7 @@ - Agent Spec Adapters - AutoGen — PyAgentSpec 26.1.0.dev0 documentation + Run Agent Spec configurations with AutoGen — PyAgentSpec 26.1.0.dev0 documentation @@ -29,32 +29,32 @@ - - + + - - - - - - + + + + + + - + - - - - - - - - - - - - - + + + + + + + + + + + + + - + - - - - - + + + + + @@ -90,7 +90,7 @@
    + @@ -173,22 +173,22 @@ @@ -228,7 +228,7 @@ - Agent Spec GitHub repository + Agent Spec GitHub repository
    • @@ -248,10 +248,6 @@ - - @@ -278,22 +274,22 @@ @@ -324,7 +320,7 @@ - Agent Spec GitHub repository + Agent Spec GitHub repository @@ -339,76 +335,88 @@

    Section Navigation

    Agent Spec

    @@ -445,14 +453,17 @@ @@ -469,33 +480,10 @@
    -
    -

    Agent Spec Adapters - AutoGen#

    -
    -Agent Spec adapter for AutoGen -
    -

    ↑ With the Agent Spec adapter for AutoGen, you can easily import agents from external frameworks using Agent Spec and run them with AutoGen.#

    -
    -
    -

    Microsoft AutoGen supports the development of multi-agent conversational systems, -allowing agents to communicate and collaborate to solve tasks.

    -
    -

    Get started#

    -

    To get started, set up your Python environment (Python 3.10 to 3.12 required), -and then install the PyAgentSpec package with the AutoGen extension.

    -
    python -m venv .venv
-source .venv/bin/activate  # On Windows: .venv\Scripts\activate
-pip install "pyagentspec[autogen]"
-
    -
    -

    You are now ready to use the adapter:

    -
      -

    • Run Agent Spec configurations with AutoGen (see more details below)

      • -

    • Convert AutoGen agents to Agent Spec (see more details below)

      • -
    -
    -
    -

    Run Agent Spec configurations with AutoGen#

    +
    +

    Run Agent Spec configurations with AutoGen#

    +

    This usage example showcases the creation of a simple Agent Spec Agent, subsequently serialized into JSON and converted into an AutoGen +assistant. Also includes mapping of a ServerTool and execution of the conversation.

    # Create a Agent Spec agent
 from pyagentspec.agent import Agent
 from pyagentspec.llms.openaicompatibleconfig import OpenAiCompatibleConfig
@@ -550,40 +538,6 @@ 
    Get started# AGENT >> The result of the subtraction is 864197532.
    -
    -
    -

    Convert AutoGen agents to Agent Spec#

    -
    # Create an AutoGen Agent
-import os
-os.environ["OPENAI_API_KEY"] = "YOUR_API_KEY"
-from autogen_agentchat.agents import AssistantAgent
-from autogen_ext.models.openai import OpenAIChatCompletionClient
-
-async def add_tool(a: int, b: int) -> int:
-    """Adds a to b and returns the result"""
-    return a + b
-
-autogen_tools = {"add_tool": add_tool}
-
-model_client = OpenAIChatCompletionClient(
-    model="gpt-4.1",
-)
-
-autogen_agent = AssistantAgent(
-    name="assistant",
-    model_client=model_client,
-    tools=list(autogen_tools.values()),
-    system_message="Use tools to solve tasks, and reformulate the answers that you get.",
-    reflect_on_tool_use=True,
-)
-
-# Convert to Agent Spec
-from pyagentspec.adapters.autogen import AgentSpecExporter
-
-agentspec_config = AgentSpecExporter().to_json(autogen_agent)
-
    -
    -
    @@ -597,26 +551,6 @@

    Get started - -