与结构化调用类似,就是一个记录
环境准备
需要安装llama-cpp-agent 以及启动一个llama-server
- 安装
- 服务启动
Linux 环境自己编译的llama-server
llama-cpp-agent 代码调用
- demo2.py
from llama_cpp_agent import FunctionCallingAgent,LlamaCppFunctionTool
from llama_cpp_agent.providers import LlamaCppServerProvider
from llama_cpp_agent.llm_output_settings import LlmStructuredOutputSettings
provider = LlamaCppServerProvider("http://localhost:8080")
# 注意函数注释以及类型定义是必须的,否则运行会有错误提示
def add(a:int,b:int) ->int:
"""
add two numbers
Args:
a: int
b: int
"""
return a+b
# 注意函数注释以及类型定义是必须的,否则运行会有错误提示
def sub(a:int,b:int) ->int:
"""
sub two numbers
Args:
a: int
b: int
"""
return a - b
output_settings = LlmStructuredOutputSettings.from_functions([add,sub],allow_parallel_function_calling=True)
add_function_tool = LlamaCppFunctionTool(add)
sub_function_tool = LlamaCppFunctionTool(sub)
agent = FunctionCallingAgent(
llama_llm=provider,
debug_output=True,
llama_cpp_function_tools=[add_function_tool,sub_function_tool],
allow_parallel_function_calling=True,
system_prompt="你是一个强大的人工智能助手,通过基于json格式进行函数调用",
)
msg = agent.generate_response("我现在有500元,我买东西花了300元,我现在还有多少,你能帮我计算一下吗?")
print(msg)
输出结果
<|im_start|>system
Read and follow the instructions below:
<system_instructions>
你是一个强大的人工智能助手,通过基于json格式进行函数调用
</system_instructions>
You can call functions to help you with your tasks and user queries. The available functions are:
<function_list>
Function: add
Description: add two numbers
Parameters:
a (int): int
b (int): int
Function: sub
Description: sub two numbers
Parameters:
a (int): int
b (int): int
Function: send_message
Description: Sends a message to the user.
Parameters:
content (str): Content of the message to be sent.
</function_list>
To call a function, respond with a JSON object (to call one function) or a list of JSON objects (to call multiple functions), with each object containing these fields:
- "thoughts_and_reasoning": Write your thoughts and reasoning for calling the function here. Think step-by-step about what information you need.
- "function": Put the name of the function to call here.
- "arguments": Put the arguments to pass to the function here.
The result of each function call will be returned to you before you need to respond again.<|im_end|>
<|im_start|>user
我现在有500元,我买东西花了300元,我现在还有多少,你能帮我计算一下吗?<|im_end|>
<|im_start|>assistant
[
{
"thoughts_and_reasoning": "I need to subtract the amount spent from the initial amount to find the remaining balance.",
"function": "sub",
"arguments": {
"a": 500,
"b": 300
}
}
]
<|im_start|>system
Read and follow the instructions below:
<system_instructions>
你是一个强大的人工智能助手,通过基于json格式进行函数调用
</system_instructions>
You can call functions to help you with your tasks and user queries. The available functions are:
<function_list>
Function: add
Description: add two numbers
Parameters:
a (int): int
b (int): int
Function: sub
Description: sub two numbers
Parameters:
a (int): int
b (int): int
Function: send_message
Description: Sends a message to the user.
Parameters:
content (str): Content of the message to be sent.
</function_list>
To call a function, respond with a JSON object (to call one function) or a list of JSON objects (to call multiple functions), with each object containing these fields:
- "thoughts_and_reasoning": Write your thoughts and reasoning for calling the function here. Think step-by-step about what information you need.
- "function": Put the name of the function to call here.
- "arguments": Put the arguments to pass to the function here.
The result of each function call will be returned to you before you need to respond again.<|im_end|>
<|im_start|>user
我现在有500元,我买东西花了300元,我现在还有多少,你能帮我计算一下吗?<|im_end|>
<|im_start|>assistant
[
{
"thoughts_and_reasoning": "I need to subtract the amount spent from the initial amount to find the remaining balance.",
"function": "sub",
"arguments": {
"a": 500,
"b": 300
}
}
]<|im_end|>
<|im_start|>function
Function Calling Results:
1. Function: "sub"
Return Value: 200<|im_end|>
<|im_start|>assistant
[
{
"thoughts_and_reasoning": "After subtracting the spent amount from the initial amount, you are left with 200元.",
"function": "send_message",
"arguments": {
"content": "您还有200元。"
}
}
]
您还有200元。
[{'function': 'send_message', 'arguments': {'content': '您还有200元。'}, 'return_value': 'Message sent.'}]
- 1.
- 2.
- 3.
- 4.
- 5.
- 6.
- 7.
- 8.
- 9.
- 10.
- 11.
- 12.
- 13.
- 14.
- 15.
- 16.
- 17.
- 18.
- 19.
- 20.
- 21.
- 22.
- 23.
- 24.
- 25.
- 26.
- 27.
- 28.
- 29.
- 30.
- 31.
- 32.
- 33.
- 34.
- 35.
- 36.
- 37.
- 38.
- 39.
- 40.
- 41.
- 42.
- 43.
- 44.
- 45.
- 46.
- 47.
- 48.
- 49.
- 50.
- 51.
- 52.
- 53.
- 54.
- 55.
- 56.
- 57.
- 58.
- 59.
- 60.
- 61.
- 62.
- 63.
- 64.
- 65.
- 66.
- 67.
- 68.
- 69.
- 70.
- 71.
- 72.
- 73.
- 74.
- 75.
- 76.
- 77.
- 78.
- 79.
- 80.
- 81.
- 82.
- 83.
- 84.
- 85.
- 86.
- 87.
- 88.
- 89.
- 90.
- 91.
- 92.
- 93.
- 94.
- 95.
- 96.
- 97.
- 98.
- 99.
- 100.
- 101.
- 102.
- 103.
- 104.
- 105.
- 106.
- 107.
- 108.
- 109.
- 110.
- 111.
- 112.
- 113.
- 114.
- 115.
- 116.
- 117.
- 118.
- 119.
- 120.
- 121.
- 122.
- 123.
- 124.
- 125.
- 126.
- 127.
- 128.
- 129.
- 130.
- 131.
- 132.
- 133.
- 134.
- 135.
- 136.
- 137.
- 138.
- 139.
- 140.
- 141.
- 142.
- 143.
- 144.
- 145.
- 146.
- 147.
- 148.
- 149.
- 150.
- 151.
- 152.
- 153.
- 154.
- 155.
- 156.
- 157.
- 158.
说明
从实际调用的日志来看,llama-cpp-agent 为了确保函数调用的稳定性,实际上使用的还是结构化输出,并不是类似openai 的json schema 定义,只是进行了一些改进,与结构化输出的处理基本类似(还包含了一个callback)
参考资料
https://github.com/Maximilian-Winter/llama-cpp-agent
https://github.com/ggerganov/llama.cpp/blob/master/docs/build.md
https://llama-cpp-agent.readthedocs.io/en/latest/
https://llama-cpp-agent.readthedocs.io/en/latest/function-calling-agent/