superagent py

Superagente Python SDK?

A estrutura aberta para a construção de assistentes de IA

---

Superagent é uma estrutura de código aberto que permite a qualquer desenvolvedor integrar assistentes de IA prontos para produção em qualquer aplicativo em questão de minutos.

---

Instalação

Adicione esta dependência ao arquivo de construção do seu projeto:

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

Uso

 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 )

Cliente assíncrono

 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 )

Tratamento de exceções

Todas as exceções lançadas pelo SDK serão subclassificadas moneykit.ApiError.

 from superagent . core import ApiError

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

Os códigos de erro são os seguintes:

Código de status	Tipo de erro
422	UnprocessableEntityError

Agradecimentos

Um agradecimento especial à equipe Fern por todo suporte com as bibliotecas e SDKs Superagent ❤️.

Estado beta

Este SDK está em beta e pode haver alterações significativas entre versões sem uma atualização de versão principal. Portanto, recomendamos fixar a versão do pacote em uma versão específica em seu arquivo pyproject.toml. Dessa forma, você pode instalar a mesma versão sempre sem interromper as alterações, a menos que esteja procurando intencionalmente pela versão mais recente.

Contribuindo

Embora valorizemos as contribuições de código aberto para este SDK, esta biblioteca é gerada programaticamente. Adições feitas diretamente a esta biblioteca teriam que ser movidas para nosso código de geração, caso contrário seriam substituídas na próxima versão gerada. Sinta-se à vontade para abrir um PR como prova de conceito, mas saiba que não poderemos fundi-lo como está. Sugerimos abrir uma edição primeiro para discutir conosco!

Por outro lado, contribuições para o README são sempre muito bem-vindas!