Changelog#

Agent Spec 26.1.0.dev0#

New features#

  • Added LangGraph adapter to pyagentspec:

    The LangGraph adapter is now available as part of pyagentspec. You can access its functionality through the pyagentspec.adapters.langgraph subpackage. It requires the langgraph extra dependency to be installed.

    For more information read the API Reference.

  • Added AutoGen adapter to pyagentspec:

    The AutoGen adapter is now available as part of pyagentspec. You can access its functionality through the pyagentspec.adapters.autogen subpackage. It requires the autogen extra dependency to be installed.

    For more information read the API Reference.

  • Sensitive Fields Support:

    New fields have been added to Agent Spec components that may carry sensitive data (e.g. the field api_key on OpenAiCompatibleConfig). To provide this functionality securely, we also introduced the annotation SensitiveField such that the sensitive fields are automatically excluded when exporting a Component to its JSON or yaml configuration.

    For more information read the latest specification.

  • OpenAI Responses API Support:

    OpenAiCompatibleConfig and OpenAIModel now support the OpenAI Responses API, which can be configured using the api_type parameter, which accepts values from OpenAIAPIType.

    This enhancement allows recent OpenAI models to better leverage advanced reasoning capabilities, resulting in significant performance improvements in workflows.

    For more information read the API Reference.

  • OCI Responses API Support:

    OciGenAiConfig now supports the OCI Responses API, which can be configured using the api_type parameter, which accepts values from OciAPIType.

    This enhancement allows recent models to better leverage advanced reasoning capabilities, resulting in significant performance improvements in workflows.

    For more information read the API Reference.

  • ParallelFlowNode and ParallelMapNode

    Added support for parallelization in Agent Spec through ParallelFlowNode, which runs several flows in parallel, and ParallelMapNode, which is a parallel version of the MapNode. For more information, check out the corresponding parallel flows how-to guide and map-reduce how-to guide.

  • Tools with User Confirmation

    Tools now have a new flag named requires_confirmation, which can be set to require user/operator approval before running the tool. For more information read the API Reference.

  • ToolBoxes

    Toolboxes are now available in the Agent Spec Language Specification and can be passed to Agents. For more information read the API Reference.

  • BuiltinTool

    Executor-specific built-in tools are now available in the Agent Spec Language Specification. For more information read the API Reference.

  • Structured Generation

    Formally introduced Structured Generation in the Agent Spec Language Specification. Structured Generation is now supported in the LlmNode, as well as the Agent.

  • Swarm

    Introduced Swarm in the Agent Spec Language Specification. For more information check out the corresponding swarm how-to guide or read the API Reference.

  • AgentSpecialization

    Introduced the concept of agent specialization in the Agent Spec Language Specification, which allows to tailor general-purpose Agents to specific use-cases. For more information read the API Reference.

  • ManagerWorkers

    Introduced ManagerWorkers in the Agent Spec Language Specification. For more information check out the corresponding managerworkers how-to guide or read the API Reference.

Improvements#

  • Python 3.14 support

    Introduced support for Python version 3.14.

Breaking Changes#

  • Sensitive Fields

The below fields have been marked as carrying sensitive information and will be excluded from newly generated configurations automatically. See latest specification for more information on this. This change is implemented retroactively to impact older configurations too.

SSEmTLSTransport

key_file

SSEmTLSTransport

cert_file

SSEmTLSTransport

ca_file

StreamableHTTPmTLSTransport

key_file

StreamableHTTPmTLSTransport

cert_file

StreamableHTTPmTLSTransport

ca_file

These field will now require to be passed explicitly when loading an exported configuration, as in the example below:

AgentSpecDeserializer().from_yaml(
    serialized_component,
    components_registry={
        "<component_id>.key_file": "client.key",
        "<component_id>.cert_file": "client.crt",
        "<component_id>.ca_file": "trustedCA.pem",
    },
)

Agent Spec 25.4.1 — Initial release#

Agent Spec is now available: Quickly build portable, framework and language-agnostic agents!

This initial release establishes the foundation of the Agent Spec ecosystem with the first version of the language specification, a Python SDK (PyAgentSpec) for simplified agent development, and a set of adapters that enable running Agent Spec representations on several popular, publicly available agent frameworks.

Explore further: