Improved tool use with Llama 4
{{- bos_token }}
{%- if custom_tools is defined %}
{%- set tools = custom_tools %}
{%- endif %}
{%- if not tools_in_user_message is defined %}
{%- set tools_in_user_message = true %}
{%- endif %}
{%- if not date_string is defined %}
{%- if strftime_now is defined %}
{%- set date_string = strftime_now("%d %b %Y") %}
{%- else %}
{%- set date_string = "26 Jul 2024" %}
{%- endif %}
{%- endif %}
{%- if not tools is defined %}
{%- set tools = none %}
{%- endif %}
{#- This block extracts the system message, so we can slot it into the right place. #}
{%- if messages[0]['role'] == 'system' %}
{%- if messages[0]['content'] is string %}
{%- set system_message = messages[0]['content']|trim %}
{%- else %}
{#- FIXME: The processor requires an array, always. #}
{%- set system_message = messages[0]['content'][0]['text']|trim %}
{%- endif %}
{%- set messages = messages[1:] %}
{%- set user_supplied_system_message = true %}
{%- else %}
{%- set system_message = "" %}
{%- set user_supplied_system_message = false %}
{%- endif %}
{#- System message if the user supplied one #}
{%- if user_supplied_system_message %}
{{- "<|header_start|>system<|header_end|>\n\n" }}
{%- if tools is not none %}
{{- "Environment: ipython\n" }}
{%- endif %}
{%- if tools is not none and not tools_in_user_message %}
{{- "You are an expert in using functions/tools when necessary. You are given a query and a set of possible functions."}}
{{- "Based on the query, call one or more functions to achieve the purpose, if applicable.\n\n"}}
{{- "If no functions apply, do not call any. Make sure to use any parameters specified as required. "}}
{{- "If the given query lacks the parameters required by the function, "}}
{{- "point it out. If a function response is given after you call a function, use it if it answers the query. "}}
{{- "You should only output function calls in tool call sections.\n\n" }}
{{- 'Respond in the format {"name": function name, "parameters": dictionary of argument names and their values}. ' }}
{{- "For number argument values, you do not need to wrap in quotes. If you use quotes, use double quotes. "}}
{{- "Do not use variables. Here is a list of the only functions you can invoke, in JSON format.\n\n" }}
{%- for t in tools %}
{{- t | tojson(indent=4) }}
{{- "\n\n" }}
{%- endfor %}
{%- endif %}
{{- system_message }}
{{- "<|eot|>" }}
{%- endif %}
{#- Custom tools are passed in a user message with some extra guidance #}
{%- if tools_in_user_message and not tools is none %}
{#- Extract the first user message so we can plug it in here #}
{%- if messages | length != 0 %}
{%- if messages[0]['content'] is string %}
{%- set first_user_message = messages[0]['content']|trim %}
{%- else %}
{#- expect messages[0]['content'] to be a list of objects #}
{%- set first_user_message = messages[0]['content'][0]['text']|trim %}
{%- endif %}
{%- set messages = messages[1:] %}
{%- else %}
{{- raise_exception("Cannot put tools in the first user message when there's no first user message!") }}
{%- endif %}
{{- '<|header_start|>user<|header_end|>\n\n' -}}
{{- "You are an expert in using functions/tools when necessary. You are given a query and a set of possible functions."}}
{{- "Based on the query, call one or more functions to achieve the purpose, if applicable.\n\n"}}
{{- "If no functions apply, do not call any. Make sure to use any parameters specified as required. "}}
{{- "If the given query lacks the parameters required by the function, "}}
{{- "point it out. If a function response is given after you call a function, use it if it answers the query. "}}
{{- "You should only output function calls in tool call sections.\n\n" }}
{{- 'Respond in the format {"name": function name, "parameters": dictionary of argument names and their values}. ' }}
{{- "For number argument values, you do not need to wrap in quotes. If you use quotes, use double quotes. "}}
{{- "Do not use variables. Here is a list of the only functions you can invoke, in JSON format.\n\n" }}
{%- for t in tools %}
{{- t | tojson(indent=4) }}
{{- "\n\n" }}
{%- endfor %}
{{- first_user_message + "<|eot|>"}}
{%- endif %}
{%- for message in messages %}
{%- if not (message.role == 'ipython' or message.role == 'tool' or 'tool_calls' in message) %}
{{- '<|header_start|>' + message['role'] + '<|header_end|>\n\n' }}
{%- if message['content'] is string %}
{{- message['content'] }}
{%- else %}
{%- for content in message['content'] %}
{%- if content['type'] == 'image' %}
{{- '<|image|>' }}
{%- elif content['type'] == 'text' %}
{{- content['text'] }}
{%- endif %}
{%- endfor %}
{%- endif %}
{{- "<|eot|>" }}
{%- elif 'tool_calls' in message and message.tool_calls|length > 0 %}
{{- '<|header_start|>assistant<|header_end|>\n\n' -}}
{{- '<|python_start|>' }}
{%- if message['content'] is string %}
{{- message['content'] }}
{%- else %}
{%- for content in message['content'] %}
{%- if content['type'] == 'image' %}
{{- '<|image|>' }}
{%- elif content['type'] == 'text' %}
{{- content['text'] }}
{%- endif %}
{%- endfor %}
{%- endif %}
{{- '<|python_end|>' }}
{%- for tool_call in message.tool_calls %}
{{- '{"name": "' + tool_call.function.name + '", ' }}
{{- '"parameters": ' }}
{{- tool_call.function.arguments | tojson }}
{{- "}" }}
{%- endfor %}
{{- "<|eot|>" }}
{%- elif message.role == "tool" or message.role == "ipython" %}
{{- "<|header_start|>ipython<|header_end|>\n\n" }}
{%- if message.content is iterable and message.content is not string %}
{{- message.content | tojson }}
{%- else %}
{{- message.content }}
{%- endif %}
{{- "<|eot|>" }}
{%- endif %}
{%- endfor %}
{%- if add_generation_prompt %}
{{- '<|header_start|>assistant<|header_end|>\n\n' }}
{%- endif %}