⚡️ sema4ai-actions

一个Python库，旨在简化与Sema4.ai动作服务器一起运行的Python动作（AI或其他）的开发。

入门指南

如果您还没有设置动作服务器，请查看🏃‍♂️ 快速入门以了解如何进行操作。

使用@action装饰器装饰您的Python函数

from sema4ai.actions import action

@action
def sum_numbers(a: float, b: float) -> float:
    ...

现在您的函数就是一个⚡️动作了！

您现在可以通过使用action-server start启动动作服务器并访问http://localhost:8080的UI来运行和调试您的动作。

注意：动作输入和输出只支持int、float、str和bool类型。

描述您的动作

为了使AI模型（和人类）理解动作的目的和使用方式，它需要正确地进行文档记录。

为此，请使用Google样式文档字符串来编写清晰简洁的描述，说明您的动作做什么，并记录动作输入和预期输出。

@action
def get_weather_forecast(city: str, days: int, scale: str = "celsius") -> str:
    """
    Returns weather conditions forecast for a given city.

    Args:
        city (str): Target city to get the weather conditions for
        days: How many day forecast to return
        scale (str): Temperature scale to use, should be one of "celsius" or "fahrenheit"

    Returns:
        str: The requested weather conditions forecast
    """
    ...

提示：在您使用AI应用中的动作时，通过实验和迭代精确的文档措辞来获得更可预测的结果。

后果标志

您可以为动作显式提供 is_consequential 标志，将其操作标记为“必须始终在运行前提示用户确认”由 OpenAI GPTs （以及其他可能的提供商）。如果设置为 False，用户将获得一个“始终允许”的功能。

@action(is_consequential=True)
def get_weather_forecast(city: str, days: int, scale: str = "celsius") -> str:

执行

为了获得您动作的完整好处，建议使用动作服务器来运行它们。但也可以通过传递命名参数直接在命令行中执行。

python -m sema4ai.actions run -- --city=Helsinki --days=3

指南

• 请求头

API参考

探索我们的API，获取详细的文档。

变更日志

可以在变更日志中找到发布列表和相应的更改。