ToolACE-2.5-Llama-3.1-8B

ToolACE-2.5-Llama-3.1-8B

ToolACE-2.5-Llama-3.1-8B is a fine-tuned model of LLaMA-3.1-8B-Instruct with our dataset ToolACE tailored for tool usage. Compared with ToolACE-2, ToolACE-2.5-8B enhances the multi-turn tool-usage ability.

ToolACE is an automatic agentic pipeline designed to generate Accurate, Complex, and divErse tool-learning data. ToolACE leverages a novel self-evolution synthesis process to curate a comprehensive API pool of 26,507 diverse APIs. Dialogs are further generated through the interplay among multiple agents, guided by a formalized thinking process. To ensure data accuracy, we implement a dual-layer verification system combining rule-based and model-based checks. More details can be found in our paper: ToolACE: Winning the Points of LLM Function Calling

More techniques are applied to further improve tool-usage ability, including:

• ToolACE-R: Model-aware Iterative Training and Adaptive Refinement for Tool Learning
• ToolACE-DEV: Self-Improving Tool Learning via Decomposition and EVolution
• ToolACE-MT: Non-Autoregressive Generation for Agentic Multi-Turn Interaction

Usage

Here we provide a code snippet with apply_chat_template to show you how to load the tokenizer and model and how to generate function calling with given functions.

from transformers import AutoModelForCausalLM, AutoTokenizer

model_name = "Team-ACE/ToolACE-2.5-Llama-3.1-8B"

tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForCausalLM.from_pretrained(
    model_name,
    torch_dtype='auto',
    device_map='auto'
)


# You can modify the prompt for your task
system_prompt = """You are an expert in composing functions. You are given a question and a set of possible functions. Based on the question, you will need to make one or more function/tool calls to achieve the purpose.
If none of the function can be used, point it out. If the given question lacks the parameters required by the function, also point it out.
You should only return the function call in tools call sections.

If you decide to invoke any of the function(s), you MUST put it in the format of [func_name1(params_name1=params_value1, params_name2=params_value2...), func_name2(params)]
You SHOULD NOT include any other text in the response.
Here is a list of functions in JSON format that you can invoke.\n{functions}\n
"""

# User query
query = "Find me the sales growth rate for company XYZ for the last 3 years and also the interest coverage ratio for the same duration."

# Availabel tools in JSON format (OpenAI-format)
tools = [
    {
        "name": "financial_ratios.interest_coverage", "description": "Calculate a company's interest coverage ratio given the company name and duration",
        "arguments": {
            "type": "dict",
            "properties": {
                "company_name": {
                    "type": "string",
                    "description": "The name of the company."
                }, 
                "years": {
                    "type": "integer",
                    "description": "Number of past years to calculate the ratio."
                }
            }, 
            "required": ["company_name", "years"]
        }
    },
    {
        "name": "sales_growth.calculate",
        "description": "Calculate a company's sales growth rate given the company name and duration",
        "arguments": {
            "type": "dict", 
            "properties": {
                "company": {
                    "type": "string",
                    "description": "The company that you want to get the sales growth rate for."
                }, 
                "years": {
                    "type": "integer",
                    "description": "Number of past years for which to calculate the sales growth rate."
                }
            }, 
            "required": ["company", "years"]
        }
    },
    {
        "name": "weather_forecast",
        "description": "Retrieve a weather forecast for a specific location and time frame.",
        "arguments": {
            "type": "dict",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "The city that you want to get the weather for."
                }, 
                "days": {
                    "type": "integer",
                    "description": "Number of days for the forecast."
                }
            },
            "required": ["location", "days"]
        }
    }
]

messages = [
    {'role': 'system', 'content': system_prompt.format(functions=tools)},
    {'role': 'user', 'content': query}
]

inputs = tokenizer.apply_chat_template(messages, add_generation_prompt=True, return_tensors="pt").to(model.device)

outputs = model.generate(inputs, max_new_tokens=512, do_sample=False, num_return_sequences=1, eos_token_id=tokenizer.eos_token_id)
print(tokenizer.decode(outputs[0][len(inputs[0]):], skip_special_tokens=True))

Then you should be able to see the following output functional calls:

[sales_growth.calculate(company="XYZ", years=3), financial_ratios.interest_coverage(company_name="XYZ", years=3)]

Citation

If you think ToolACE is useful in your work, please cite our paper:

@inproceedings{
  liu2025toolace,
  title={Tool{ACE}: Winning the Points of {LLM} Function Calling},
  author={Weiwen Liu and Xu Huang and Xingshan Zeng and xinlong hao and Shuai Yu and Dexun Li and Shuai Wang and Weinan Gan and Zhengying Liu and Yuanqing Yu and Zezhong WANG and Yuxian Wang and Wu Ning and Yutai Hou and Bin Wang and Chuhan Wu and Wang Xinzhi and Yong Liu and Yasheng Wang and Duyu Tang and Dandan Tu and Lifeng Shang and Xin Jiang and Ruiming Tang and Defu Lian and Qun Liu and Enhong Chen},
  booktitle={The Thirteenth International Conference on Learning Representations},
  year={2025},
  url={https://openreview.net/forum?id=8EB8k6DdCU}
}

Additionally, please check our other related works whose techniques are applied in ToolACE-2.5-8B:

@article{zeng2025toolacer,
  title={ToolACE-R: Model-aware Iterative Training and Adaptive Refinement for Tool Learning},
  author={Zeng, Xingshan and Liu, Weiwen and Huang, Xu and Wang, Zezhong and Wang, Lingzhi and Li, Liangyou and Wang, Yasheng and Shang, Lifeng and Jiang, Xin and Tang, Ruiming and Liu, Qun},
  journal={arXiv preprint arXiv:2504.01400},
  year={2025}
}

@article{huang2025toolace,
  title={ToolACE-DEV: Self-Improving Tool Learning via Decomposition and EVolution},
  author={Huang, Xu and Liu, Weiwen and Zeng, Xingshan and Huang, Yuefeng and Hao, Xinlong and Wang, Yuxian and Zeng, Yirong and Wu, Chuhan and Wang, Yasheng and Tang, Ruiming and Lian, Defu},
  journal={arXiv preprint arXiv:2505.07512},
  year={2025}
}

@article{zeng2025toolacemt,
  title={ToolACE-MT: Non-Autoregressive Generation for Agentic Multi-Turn Interaction},
  author={Zeng, Xingshan and Liu, Weiwen and Wang, Lingzhi and Li, Liangyou and Mi, Fei and Wang, Yasheng and Shang, Lifeng and Jiang, Xin and Liu, Qun},
  journal={arXiv preprint arXiv:2508.12685},
  year={2025}
}