Skip to content

Releases

In this release log, we cover all versions of our AI Refinery SDK, listed in order from the most recent to the oldest.

1.10.2

Release Date: Jun 10, 2025

AIRefinery SDK is now available on PyPI. You can install it with a single command: 

pip install airefinery-sdk

1.10.1

Release Date: Jun 09, 2025

airefinery_sdk-1.10.1-py3-none-any.whl

New Features

  • New Trusted Agent Huddle Agents:

  • Knowledge - semantic layer:

    • Supports two different knowledge graph modules: GraphRAG, FastGraphRAG, to convert documents into knowledge graphs.
    • In addition to graph building, the Knowledge Graph API supports
    • Graph Queries – Query the knowledge base.
    • Graph Updates – Incrementally add new information to the graph.
    • Graph Visualization – Visualize any existing graph structure.

  • New Research Agent Custom Retriever

    • Research Agent now supports CustomRetriever, a callable to be added to the SDK executor_dict to support any user-defined Vector Database.

  • Service Bugfix:

    • Bug fixes and performance improvements over 1.9.1.

Improvements

1.9.1

Release Date: May 27, 2025

New Features

  • Visualization by Analytics Agent:

    • The Analytics Agent now supports visualizations.
    • Creates visualizations using built-in Apache ECharts templates.
    • Allows for custom Apache ECharts templates in your project configuration.

  • Metadata from Analytics Agent:

    • The Analytics Agent will now include executed commands and their results in the metadata attribute of the response.

  • Personally Identifiable Information (PII) Masking:

    • Supports masking PII entities in both plain text and nested JSON structures.
    • Routes all query requests through the PII handler before sending to the backend.

Improvements

  • Memory Retrieval Bugfix:
    • Fixed intermittent None returns from DistillerClient.retrieve_memory()

Compatibility

  • We encourage you to update to the latest SDK to enjoy the new features and performance improvements.
  • The input_guardrails configuration of the Orchestrator has been removed. You can now use our advanced Responsible AI module to apply safety or policy rules to your project.
  • If you do not update the SDK to 1.9.0, no changes to your project code are necessary.
  • If you update the SDK to 1.9.0, you should replace: OpenAI and AsyncOpenAI clients and use our new dedicated AIRefinery and AsyncAIRefinery clients for model inference.

1.8.0

Release Date: May 13, 2025

New Features

  • Support for Model Control Protocol (MCP):
    • Enables agents to interact with external tools via MCP servers using the Server-Sent Events (SSE) protocol.
    • Includes the new MCPClientAgent in the SDK.
    • Provides a rich catalog of example MCP servers.

1.7.4

May 5, 2025

New Features

  • You can now retrieve chat history from memory in a json_string format for easier parsing. This the line you need to use in your SDK application:
await dc.retrieve_memory(source="chat_history", format='json_string')

Improvements

  • Fixed security vulnerabilities in AIRefinery service: sessions are now limited to remain idle (no new queries in processing) for a maximum of 15 minutes of inactivity.

1.7.2

April 21, 2025

Improvements

Minor changes and bugfixes:

  • Memory resetting operation now deletes all user data stored on the server.
  • The turn definition in chat history now refers to a One User Query + All related agent responses.
  • New support for Mistral 7B Instruct v0.3
  • We have migrated Compression, Reranker and Image Generation models from A100 to H100.

1.7.0

April 8, 2025

New Features

  • We introduce AzureAIAgent - A new Agent based on Azure AI that allows for a connection with the Azure AI agents platform. Check out this documentation to learn more about this agent.
  • We introduce EvaluationSuperAgent - A new SuperAgent that evaluates the agentic responses against configurable metrics. Check out this documentation to learn more about this agent.
  • We introduce DocumentProcessingClient - A new Knowledge extraction feature is now available to convert 5 types of input documents (PDF, PPTX, DOCX, DOC, PPT) to searchable knowledge. Support includes text, table and images extraction, chunking , embedding and uploading documents. Check out this documentation to learn more about this feature.

Improvements

  • Bug fixes: We fixed several bugs reported by the community.
  • Infrastructure improvement: We have improved our infrastructure to bring in nearly 2x speedup for the agent response in AIRefinery.

Compatibility

  • No changes to your project code are necessary.
  • Note: meta-llama/Llama-3.1-70B-Instruct-NIM is now replaced by meta-llama/Llama-3.1-70B-Instruct. Please update your configuration yaml file as needed.

1.6.0

March 17, 2025

New Features

  • We introduce FlowSuperAgent - A new type of super agent designed to orchestrate complex workflows composed of multiple utility agents with pre-defined dependencies. For more details, please check out this tutorial.

Improvements

  • Bug fixes: We fix bugs including Super Agents' unexpected behavior, chat history memory bugs, duplicated Custom Agent memory instances.
  • Endpoint scalability: We scale AIRefinery Agent-as-a-service platform to support more concurrent users.

Compatibility

  • We encourage you to update to the latest SDK to enjoy the new performance improvements. No changes to your project code are necessary.

1.5.1

Feb 25, 2025

New Features

  • Support for Long Blocking Operations: We add support for long blocking operations in both asynchronous and synchronous custom agents. This enhancement enables developers to handle more complex operations with custom agents.
  • Extend Memory Configuration: Users can now update the memory configuration to track longer conversational turns in the memory history, allowing for more context-aware interactions.

Improvements

  • Optimize the efficiency of internal memory updates, enhancing overall performance.
  • Resolve an issue where an empty configuration dictionary was required in Version 1.5.0 for custom agents.

Compatibility

  • Please make a small update to your current code for version 1.5.0. In version 1.5.1 (if you are using the kwargs for the custom agents), it is now required to explicitly specify the requested arguments in the function signature. See the change below:
# Original code
async def data_extractor_agent(query: Optional[str]= None, **kwargs) -> str:
    print(kwargs["env_variable"])

# Updated code
async def data_extractor_agent(query: Optional[str]= None, env_variable: Optional[str]=None, chat_history: Optional[str]=None) -> str:|
    print(env_variable)

1.5.0

Feb 21, 2025

New Features 

  • We introduce a powerful new pre-built analytics agent capable of analyzing your database (PostgreSQL) or spreadsheets (CSV files).

Improvements

  • Improve the project version control feature introduced in 1.4.0, making it faster to respond and connect at launch time.

  • Re-design the logic for the custom agent gallery. Instead of creating separate processes, they now operate as individual threads. This improves compatibility with non-pickleable objects and makes responses faster as well.

Compatibility

  • The APIs are compatible with Version 1.1.1, so no changes to your project code are necessary.

1.4.0

Feb 3, 2025

New Features 

  • SDK now supports user versioning with default behavior of connecting to the latest project configuration, and input guardrails to define the scope of your user interaction.

  • SDK now enables concurrent execution of CustomAgent, take advantage of Composite Agents to run your custom agents in parallel!

Improvements

  • Address several community-reported issues, including extending timeouts for CustomAgents to 10 minutes, better client-side error messaging, improve memory capability and agents such as SuperAgent and CriticalThinker.

Compatibility

  • The APIs are compatible with Version 1.1.1, so no changes to your project code are necessary.

1.3.1

Jan 16, 2025

Improvements

  • Address community-reported issues, mainly the reloading of the DistillerClient-related scripts when a custom agent is triggered.

Compatibility

  • The APIs are compatible with Version 1.1.1, so no changes to your project code are necessary.

1.3.0

DEC 17, 2024

New Features 

  • We introduce a new reranker model.

Improvements

  • Address several community-reported issues, including blocking custom agents and author agent bugs.

Compatibility

  • The APIs are compatible with Version 1.1.1, so no changes to your project code are necessary.

1.2.0

NOV 25, 2024

New Features 

  • Image generation capability is now available.

Improvements

  • Address several community-reported issues, including websocket versioning and print blocking.

Compatibility

  • The APIs are compatible with Version 1.1.1, so no changes to your project code are necessary.

1.1.1

NOV 7, 2024

Improvements

  • Change input to async input to respond to PONG.

  • Drop deprecated ChatClient import from UI code.

  • Fix bugs including interactive and custom agent kwargs.

Initial Release

July 22, 2024

We introduce our client-side software development kit for AI refinery: AIR-SDK.