superagent py

超级代理 Python SDK ？

用于构建人工智能助手的开放框架

---

Superagent 是一个开源框架，使任何开发人员都可以在几分钟内将生产就绪的 AI 助手集成到任何应用程序中。

---

安装

将此依赖项添加到项目的构建文件中：

pip install superagent-py
# or
poetry add superagent-py

用法

 from superagent . client import Superagent

client = Superagent ( token = "API_TOKEN" , base_url = "https://api.beta.superagent.sh" )

agent = client . agent . create ( request = {
    "name" : "My Agent" ,
    "description" : "My awesome agent" ,
    "isActive" : True ,
    "llmModel" : "GPT_4_1106_PREVIEW" ,
    "prompt" : "You are a helpful assistant"
})

output = client . agent . invoke (
    agent_id = agent . data . id ,
    input = "Hi there!" ,
    enable_streaming = False ,
    session_id = "123"
)

print ( "Received response from superagent" , agent . data )

异步客户端

 from superagent . client import AsyncSuperagent

agent = await client . agent . create ( request = {
    "name" : "My Agent" ,
    "description" : "My awesome agent" ,
    "isActive" : True ,
    "llmModel" : "GPT_4_1106_PREVIEW" ,
    "prompt" : "You are a helpful assistant"
})

output = await client . agent . invoke (
    agent_id = agent . data . id ,
    input = "Hi there!" ,
    enable_streaming = False ,
    session_id = "123"
)

print ( "Received response from superagent" , agent . data )

处理异常

SDK抛出的所有异常都会继承moneykit.ApiError。

 from superagent . core import ApiError

try :
  client . agents . get ( agent_id = "12312" )
except APIError as e :
  # handle any api related error

错误代码如下：

状态码	错误类型
第422章	UnprocessableEntityError

致谢

特别感谢 Fern 团队对 Superagent 库和 SDK 的所有支持❤️。

测试版状态

此 SDK 处于测试阶段，版本之间可能会发生重大更改，而无需进行重大版本更新。因此，我们建议将包版本固定到 pyproject.toml 文件中的特定版本。这样，您每次都可以安装相同的版本，而不会破坏更改，除非您有意寻找最新版本。

贡献

虽然我们重视对此 SDK 的开源贡献，但该库是通过编程方式生成的。直接对该库进行的添加必须移至我们的生成代码中，否则它们将在下一个生成的版本中被覆盖。请随意打开 PR 作为概念证明，但要知道我们无法按原样合并它。我们建议先打开一个问题与我们讨论！

另一方面，我们始终非常欢迎对自述文件做出贡献！