AutoGen Function Call 函数调用解析(一)

2024-09-08 15:12

本文主要是介绍AutoGen Function Call 函数调用解析(一),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

目录

一、AutoGen Function Call

1.1 register_for_llm 注册调用

1.2 register_for_execution 注册执行

1.3 三种注册方法

1.3.1 函数定义和注册分开

1.3.2 定义函数时注册

1.3.3  register_function 函数注册

二、实例


本文主要对 AutoGen Function Call 进行解析,并通过实例进行介绍。

一、AutoGen Function Call

AutoGen 支持 Function Call 功能,代理会根据 system_message 和函数描述进行调用。一个函数(工具)必须向至少两个代理注册,才能在对话中使用,一个负责调用,一个负责执行

1.1 register_for_llm 注册调用

负责调用的代理通过 register_for_llm 注册函数。

def register_for_llm(*,name: Optional[str] = None,description: Optional[str] = None,api_style: Literal["function", "tool"] = "tool") -> Callable[[F], F]

常用的参数是 name(函数名称) 和 description(函数描述)。

1.2 register_for_execution 注册执行

负责执行的代理通过 register_for_execution 注册函数。

def register_for_execution(name: Optional[str] = None) -> Callable[[F], F]

 

1.3 三种注册方法

AutoGen 支持代理三种方法注册调用和执行函数。

1.3.1 函数定义和注册分开

在定义函数后,代理分别注册函数。

from typing import Annotated, LiteralOperator = Literal["+", "-", "*", "/"]# 执行计算的函数
def calculator(a: int, b: int, operator: Annotated[Operator, "operator"]) -> int:if operator == "+":return a + belif operator == "-":return a - belif operator == "*":return a * belif operator == "/":return int(a / b)else:raise ValueError("Invalid operator")# 注册方法一
# assistant 注册函数调用
assistant.register_for_llm(name="calculator", description="A simple calculator")(calculator)# user_proxy 注册执行
user_proxy.register_for_execution(name="calculator")(calculator)

1.3.2 定义函数时注册

在定义函数时,代理注册函数。

from typing import Annotated, LiteralOperator = Literal["+", "-", "*", "/"]# 注册方法二
@user_proxy.register_for_execution()
@assistant.register_for_llm(name="calculator", description="A simple calculator")
def calculator(a: int, b: int, operator: Annotated[Operator, "operator"]) -> int:if operator == "+":return a + belif operator == "-":return a - belif operator == "*":return a * belif operator == "/":return int(a / b)else:raise ValueError("Invalid operator")

1.3.3  register_function 函数注册

通过 register_function 函数一起注册。

from typing import Annotated, LiteralOperator = Literal["+", "-", "*", "/"]def calculator(a: int, b: int, operator: Annotated[Operator, "operator"]) -> int:if operator == "+":return a + belif operator == "-":return a - belif operator == "*":return a * belif operator == "/":return int(a / b)else:raise ValueError("Invalid operator")register_function(calculator,caller=assistant,  # The assistant agent can suggest calls to the calculator.executor=user_proxy,  # The user proxy agent can execute the calculator calls.name="calculator",  # By default, the function name is used as the tool name.description="A simple calculator",  # A description of the tool.
)

二、实例

下面通过一个算数运算的实例进行说明。

from typing import Annotated, LiteralOperator = Literal["+", "-", "*", "/"]# 执行计算的函数
def calculator(a: int, b: int, operator: Annotated[Operator, "operator"]) -> int:if operator == "+":return a + belif operator == "-":return a - belif operator == "*":return a * belif operator == "/":return int(a / b)else:raise ValueError("Invalid operator")import osfrom autogen import ConversableAgent, config_list_from_json# 配置LLM
config_list = config_list_from_json(env_or_file="OAI_CONFIG_LIST",
)# 负责调用的代理
assistant = ConversableAgent(name="Assistant",system_message="You are a helpful AI assistant. ""You can help with simple calculations. ""Return 'TERMINATE' when the task is done.",llm_config={"config_list": config_list},
)# 负责执行的代理
user_proxy = ConversableAgent(name="User",llm_config=False,is_termination_msg=lambda msg: msg.get("content") is not None and "TERMINATE" in msg["content"],human_input_mode="NEVER",
)# 注册方法一
# assistant 注册函数调用
assistant.register_for_llm(name="calculator", description="A simple calculator")(calculator)# user_proxy 注册执行
user_proxy.register_for_execution(name="calculator")(calculator)'''
# 注册方法二
# register_function 支持两个代理同时注册
from autogen import register_function# Register the calculator function to the two agents.
register_function(calculator,caller=assistant,  # The assistant agent can suggest calls to the calculator.executor=user_proxy,  # The user proxy agent can execute the calculator calls.name="calculator",  # By default, the function name is used as the tool name.description="A simple calculator",  # A description of the tool.
)# 注册方法三
# 定义函数的时候注册
```
@user_proxy.register_for_execution()
@assistant.register_for_llm(name="my_function", description="This is a very useful function")
def my_function(a: Annotated[str, "description of a parameter"] = "a", b: int, c=3.14) -> str:return a + str(b * c)
```'''chat_result = user_proxy.initiate_chat(assistant, message="What is (44232 + 13312 / (232 - 32)) * 5?")

输出如下所示。

(base) D:\code\autogenstudio_images\example>python function_call.py
D:\Software\anaconda3\Lib\site-packages\paramiko\transport.py:219: CryptographyDeprecationWarning: Blowfish has been deprecated"class": algorithms.Blowfish,
User (to Assistant):What is (44232 + 13312 / (232 - 32)) * 5?-------------------------------------------------------------------------------->>>>>>>> USING AUTO REPLY...
[autogen.oai.client: 09-03 21:02:49] {329} WARNING - Model meta/llama-3.1-405b-instruct is not found. The cost will be 0. In your config_list, add field {"price" : [prompt_price_per_1k, completion_token_price_per_1k]} for customized pricing.
Assistant (to User):***** Suggested tool call (chatcmpl-tool-affd8cb937d74e0585e71a80f8b36082): calculator *****
Arguments:
{"a": 232, "b": 32, "operator": "-"}
********************************************************************************************-------------------------------------------------------------------------------->>>>>>>> EXECUTING FUNCTION calculator...
User (to Assistant):User (to Assistant):***** Response from calling tool (chatcmpl-tool-affd8cb937d74e0585e71a80f8b36082) *****
200
***************************************************************************************-------------------------------------------------------------------------------->>>>>>>> USING AUTO REPLY...
[autogen.oai.client: 09-03 21:03:11] {329} WARNING - Model meta/llama-3.1-405b-instruct is not found. The cost will be 0. In your config_list, add field {"price" : [prompt_price_per_1k, completion_token_price_per_1k]} for customized pricing.
Assistant (to User):***** Suggested tool call (chatcmpl-tool-b79bd1065ee94d228176dbc06c2a3981): calculator *****
Arguments:
{"a": 13312, "b": 200, "operator": "/"}
********************************************************************************************-------------------------------------------------------------------------------->>>>>>>> EXECUTING FUNCTION calculator...
User (to Assistant):User (to Assistant):***** Response from calling tool (chatcmpl-tool-b79bd1065ee94d228176dbc06c2a3981) *****
66
***************************************************************************************-------------------------------------------------------------------------------->>>>>>>> USING AUTO REPLY...
[autogen.oai.client: 09-03 21:06:13] {329} WARNING - Model moonshot-v1-8k is not found. The cost will be 0. In your config_list, add field {"price" : [prompt_price_per_1k, completion_token_price_per_1k]} for customized pricing.
Assistant (to User):***** Suggested tool call (calculator:0): calculator *****
Arguments:
{"a": 44232,"b": 66,"operator": "+"
}
**********************************************************-------------------------------------------------------------------------------->>>>>>>> EXECUTING FUNCTION calculator...
User (to Assistant):User (to Assistant):***** Response from calling tool (calculator:0) *****
44298
*****************************************************-------------------------------------------------------------------------------->>>>>>>> USING AUTO REPLY...
[autogen.oai.client: 09-03 21:06:17] {329} WARNING - Model meta/llama-3.1-405b-instruct is not found. The cost will be 0. In your config_list, add field {"price" : [prompt_price_per_1k, completion_token_price_per_1k]} for customized pricing.
Assistant (to User):***** Suggested tool call (chatcmpl-tool-a13b42b8e844488793527ab64b55d0ea): calculator *****
Arguments:
{"a": 44298, "b": 5, "operator": "*"}
********************************************************************************************-------------------------------------------------------------------------------->>>>>>>> EXECUTING FUNCTION calculator...
User (to Assistant):User (to Assistant):***** Response from calling tool (chatcmpl-tool-a13b42b8e844488793527ab64b55d0ea) *****
221490
***************************************************************************************-------------------------------------------------------------------------------->>>>>>>> USING AUTO REPLY...
[autogen.oai.client: 09-03 21:06:21] {329} WARNING - Model meta/llama-3.1-405b-instruct is not found. The cost will be 0. In your config_list, add field {"price" : [prompt_price_per_1k, completion_token_price_per_1k]} for customized pricing.
Assistant (to User):The answer is 221490. TERMINATE.--------------------------------------------------------------------------------

参考链接:

[1] Tool Use | AutoGen

[2] agentchat.conversable_agent | AutoGen

这篇关于AutoGen Function Call 函数调用解析(一)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1148460

相关文章

Qt实现网络数据解析的方法总结

《Qt实现网络数据解析的方法总结》在Qt中解析网络数据通常涉及接收原始字节流,并将其转换为有意义的应用层数据,这篇文章为大家介绍了详细步骤和示例,感兴趣的小伙伴可以了解下... 目录1. 网络数据接收2. 缓冲区管理(处理粘包/拆包)3. 常见数据格式解析3.1 jsON解析3.2 XML解析3.3 自定义

Golang HashMap实现原理解析

《GolangHashMap实现原理解析》HashMap是一种基于哈希表实现的键值对存储结构,它通过哈希函数将键映射到数组的索引位置,支持高效的插入、查找和删除操作,:本文主要介绍GolangH... 目录HashMap是一种基于哈希表实现的键值对存储结构,它通过哈希函数将键映射到数组的索引位置,支持

Python使用getopt处理命令行参数示例解析(最佳实践)

《Python使用getopt处理命令行参数示例解析(最佳实践)》getopt模块是Python标准库中一个简单但强大的命令行参数处理工具,它特别适合那些需要快速实现基本命令行参数解析的场景,或者需要... 目录为什么需要处理命令行参数?getopt模块基础实际应用示例与其他参数处理方式的比较常见问http

Python利用ElementTree实现快速解析XML文件

《Python利用ElementTree实现快速解析XML文件》ElementTree是Python标准库的一部分,而且是Python标准库中用于解析和操作XML数据的模块,下面小编就来和大家详细讲讲... 目录一、XML文件解析到底有多重要二、ElementTree快速入门1. 加载XML的两种方式2.

Java的栈与队列实现代码解析

《Java的栈与队列实现代码解析》栈是常见的线性数据结构,栈的特点是以先进后出的形式,后进先出,先进后出,分为栈底和栈顶,栈应用于内存的分配,表达式求值,存储临时的数据和方法的调用等,本文给大家介绍J... 目录栈的概念(Stack)栈的实现代码队列(Queue)模拟实现队列(双链表实现)循环队列(循环数组

java解析jwt中的payload的用法

《java解析jwt中的payload的用法》:本文主要介绍java解析jwt中的payload的用法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Java解析jwt中的payload1. 使用 jjwt 库步骤 1:添加依赖步骤 2:解析 JWT2. 使用 N

Python中__init__方法使用的深度解析

《Python中__init__方法使用的深度解析》在Python的面向对象编程(OOP)体系中,__init__方法如同建造房屋时的奠基仪式——它定义了对象诞生时的初始状态,下面我们就来深入了解下_... 目录一、__init__的基因图谱二、初始化过程的魔法时刻继承链中的初始化顺序self参数的奥秘默认

Python处理函数调用超时的四种方法

《Python处理函数调用超时的四种方法》在实际开发过程中,我们可能会遇到一些场景,需要对函数的执行时间进行限制,例如,当一个函数执行时间过长时,可能会导致程序卡顿、资源占用过高,因此,在某些情况下,... 目录前言func-timeout1. 安装 func-timeout2. 基本用法自定义进程subp

Java 正则表达式URL 匹配与源码全解析

《Java正则表达式URL匹配与源码全解析》在Web应用开发中,我们经常需要对URL进行格式验证,今天我们结合Java的Pattern和Matcher类,深入理解正则表达式在实际应用中... 目录1.正则表达式分解:2. 添加域名匹配 (2)3. 添加路径和查询参数匹配 (3) 4. 最终优化版本5.设计思

使用Java将DOCX文档解析为Markdown文档的代码实现

《使用Java将DOCX文档解析为Markdown文档的代码实现》在现代文档处理中,Markdown(MD)因其简洁的语法和良好的可读性,逐渐成为开发者、技术写作者和内容创作者的首选格式,然而,许多文... 目录引言1. 工具和库介绍2. 安装依赖库3. 使用Apache POI解析DOCX文档4. 将解析