superagent py

スーパーエージェントPython SDK?

AI アシスタントを構築するためのオープン フレームワーク

---

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

謝辞

Superagent ライブラリと SDK ですべてのサポートをしていただいた Fern チームに心より感謝いたします ❤️。

ベータステータス

この SDK はベータ版であり、メジャー バージョンを更新しないとバージョン間に重大な変更が発生する可能性があります。したがって、パッケージのバージョンを pyproject.toml ファイル内の特定のバージョンに固定することをお勧めします。こうすることで、意図的に最新バージョンを探している場合を除き、破壊的な変更を加えることなく、毎回同じバージョンをインストールできます。

貢献する

私たちはこの SDK へのオープンソースの貢献を重視していますが、このライブラリはプログラムによって生成されています。このライブラリに直接行われた追加は、生成コードに移動する必要があります。そうしないと、次に生成されるリリースで上書きされてしまいます。概念実証として PR を自由に開いてください。ただし、そのままではマージできないことに注意してください。まずは問題を開いて話し合うことをお勧めします。

一方、README への貢献はいつでも大歓迎です。