From 228de401c11256f86de404e8cdba1b1629f43cfc Mon Sep 17 00:00:00 2001 From: dcocco Date: Tue, 13 Jan 2026 11:41:18 +0100 Subject: [PATCH 1/3] gitignore update --- .gitignore | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.gitignore b/.gitignore index 9cd448c7b..89ff1d490 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 From 5796aafde521cae9fa20750a2661d9e491e7e8a8 Mon Sep 17 00:00:00 2001 From: dcocco Date: Tue, 13 Jan 2026 14:05:58 +0100 Subject: [PATCH 2/3] Updated deployment docs --- development/_components/llm_config_tabs.html | 10 +- .../constraints.txt | 2 +- development/_sources/adapters/autogen.rst.txt | 61 -- .../adapters/autogen/autogen_to_spec.rst.txt | 12 + .../_sources/adapters/autogen/index.rst.txt | 43 ++ .../adapters/autogen/spec_to_autogen.rst.txt | 12 + .../_sources/adapters/langgraph.rst.txt | 60 -- .../_sources/adapters/langgraph/index.rst.txt | 44 ++ .../langgraph/langgraph_to_spec.rst.txt | 11 + .../langgraph/spec_to_langgraph.rst.txt | 12 + .../index.rst.txt} | 34 +- .../adapters/wayflow/spec_to_wayflow.rst.txt | 12 + .../adapters/wayflow/wayflow_to_spec.rst.txt | 11 + .../agentspec/language_spec_nightly.rst.txt | 14 +- development/_sources/changelog.rst.txt | 11 + development/_sources/docs_home.rst.txt | 8 +- development/_static/documentation_options.js | 2 +- .../adapters/autogen/autogen_to_spec.html | 584 +++++++++++++++ development/adapters/autogen/index.html | 601 +++++++++++++++ .../spec_to_autogen.html} | 312 +++----- development/adapters/langgraph.html | 701 ------------------ development/adapters/langgraph/index.html | 601 +++++++++++++++ .../adapters/langgraph/langgraph_to_spec.html | 607 +++++++++++++++ .../adapters/langgraph/spec_to_langgraph.html | 612 +++++++++++++++ development/adapters/wayflow/index.html | 601 +++++++++++++++ .../spec_to_wayflow.html} | 312 +++----- .../adapters/wayflow/wayflow_to_spec.html | 584 +++++++++++++++ development/agentspec/index.html | 28 +- .../agentspec/intro_and_motivation.html | 28 +- .../agentspec/language_spec_25_4_1.html | 28 +- .../agentspec/language_spec_nightly.html | 46 +- development/agentspec/positioning.html | 28 +- development/agentspec/tracing.html | 32 +- development/api/a2a.html | 28 +- development/api/adapters.html | 30 +- development/api/agent.html | 28 +- development/api/agent_specialization.html | 28 +- development/api/agenticpatterns.html | 28 +- development/api/components.html | 28 +- development/api/flows.html | 46 +- development/api/index.html | 28 +- development/api/ioproperties.html | 28 +- development/api/llmmodels.html | 28 +- development/api/mcp.html | 28 +- development/api/remoteagent.html | 28 +- development/api/serialization.html | 28 +- development/api/tools.html | 46 +- development/changelog.html | 40 +- development/conduct.html | 10 +- development/contributing.html | 28 +- development/docs_home.html | 28 +- development/ecosystem/collaborations.html | 28 +- development/ecosystem/integrations.html | 30 +- development/faqs.html | 28 +- development/genindex.html | 10 +- development/howtoguides/howto_a2aagent.html | 28 +- development/howtoguides/howto_ag_ui.html | 28 +- .../howto_agent_with_remote_tools.html | 28 +- development/howtoguides/howto_agents.html | 28 +- .../howto_disaggregated_config.html | 28 +- ...o_execute_agentspec_across_frameworks.html | 30 +- .../howto_execute_agentspec_with_wayflow.html | 30 +- .../howto_flow_with_conditional_branches.html | 28 +- .../howtoguides/howto_generation_config.html | 28 +- .../howto_llm_from_different_providers.html | 28 +- .../howtoguides/howto_managerworkers.html | 28 +- development/howtoguides/howto_mapnode.html | 28 +- development/howtoguides/howto_mcp.html | 28 +- development/howtoguides/howto_ociagent.html | 28 +- .../howtoguides/howto_orchestrator_agent.html | 28 +- .../howtoguides/howto_parallelflownode.html | 28 +- development/howtoguides/howto_plugin.html | 28 +- .../howto_structured_generation.html | 28 +- development/howtoguides/howto_swarm.html | 28 +- development/howtoguides/index.html | 28 +- development/index.html | 10 +- development/installation.html | 32 +- development/misc/glossary.html | 28 +- development/misc/reference_sheet.html | 28 +- development/objects.inv | Bin 5367 -> 5476 bytes development/rfcs-template.html | 10 +- development/search.html | 10 +- development/searchindex.js | 2 +- development/security.html | 28 +- development/style_guide.html | 10 +- 85 files changed, 5720 insertions(+), 1698 deletions(-) delete mode 100644 development/_sources/adapters/autogen.rst.txt create mode 100644 development/_sources/adapters/autogen/autogen_to_spec.rst.txt create mode 100644 development/_sources/adapters/autogen/index.rst.txt create mode 100644 development/_sources/adapters/autogen/spec_to_autogen.rst.txt delete mode 100644 development/_sources/adapters/langgraph.rst.txt create mode 100644 development/_sources/adapters/langgraph/index.rst.txt create mode 100644 development/_sources/adapters/langgraph/langgraph_to_spec.rst.txt create mode 100644 development/_sources/adapters/langgraph/spec_to_langgraph.rst.txt rename development/_sources/adapters/{wayflow.rst.txt => wayflow/index.rst.txt} (50%) create mode 100644 development/_sources/adapters/wayflow/spec_to_wayflow.rst.txt create mode 100644 development/_sources/adapters/wayflow/wayflow_to_spec.rst.txt create mode 100644 development/adapters/autogen/autogen_to_spec.html create mode 100644 development/adapters/autogen/index.html rename development/adapters/{autogen.html => autogen/spec_to_autogen.html} (51%) delete mode 100644 development/adapters/langgraph.html create mode 100644 development/adapters/langgraph/index.html create mode 100644 development/adapters/langgraph/langgraph_to_spec.html create mode 100644 development/adapters/langgraph/spec_to_langgraph.html create mode 100644 development/adapters/wayflow/index.html rename development/adapters/{wayflow.html => wayflow/spec_to_wayflow.html} (51%) create mode 100644 development/adapters/wayflow/wayflow_to_spec.html diff --git a/development/_components/llm_config_tabs.html b/development/_components/llm_config_tabs.html index e6f61f564..fc1f060c1 100644 --- a/development/_components/llm_config_tabs.html +++ b/development/_components/llm_config_tabs.html @@ -10,7 +10,7 @@ - <no title> — PyAgentSpec 26.1.0.dev0 documentation + <no title> — PyAgentSpec 26.1.0.dev4 documentation @@ -136,8 +136,8 @@ - PyAgentSpec 26.1.0.dev0 documentation - Home - PyAgentSpec 26.1.0.dev0 documentation - Home + PyAgentSpec 26.1.0.dev4 documentation - Home + PyAgentSpec 26.1.0.dev4 documentation - Home @@ -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 91489e4f4..1bfe57837 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 0807aa1cb..000000000 --- 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 000000000..991553e1b --- /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 000000000..fbad985cb --- /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 000000000..4e12b7496 --- /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 7ad1cfe95..000000000 --- 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 000000000..e0955df8b --- /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 000000000..35d5c3dff --- /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 000000000..663351e11 --- /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 670482bc6..b3c92abcc 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 000000000..0c1196245 --- /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 000000000..a2b613541 --- /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 e77622452..d8bd77c98 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 c29573c14..57ee6cd65 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 e19eb1fda..5ac651e9b 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/_static/documentation_options.js b/development/_static/documentation_options.js index e8e972d18..1eaf56fc4 100644 --- a/development/_static/documentation_options.js +++ b/development/_static/documentation_options.js @@ -1,6 +1,6 @@ var DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '26.1.0.dev0', + VERSION: '26.1.0.dev4', LANGUAGE: 'en', COLLAPSE_INDEX: false, BUILDER: 'html', diff --git a/development/adapters/autogen/autogen_to_spec.html b/development/adapters/autogen/autogen_to_spec.html new file mode 100644 index 000000000..5afb41ddc --- /dev/null +++ b/development/adapters/autogen/autogen_to_spec.html @@ -0,0 +1,584 @@ + + + + + + + + + + + + + Convert AutoGen agents to Agent Spec — PyAgentSpec 26.1.0.dev4 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 000000000..ca8621eba --- /dev/null +++ b/development/adapters/autogen/index.html @@ -0,0 +1,601 @@ + + + + + + + + + + + + + Agent Spec Adapters - AutoGen — PyAgentSpec 26.1.0.dev4 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 1310f7dc5..a1220502a 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.dev4 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 - -