⚡️ robocorp-actions

⚠️ 废弃通知: 该软件包的开发已迁移，并继续在新PyPI软件包下进行： sema4ai-actions. 您可以在GitHub仓库中跟踪开发。 robocorp-actions 软件包将不再接收更新，因此请更新您的依赖项以确保持续的支持和改进。

一个Python库，旨在简化开发用于与 Robocorp Action Server 一起运行的Python操作（AI或其他）。

入门

如果您尚未设置Action Server，请参阅 🏃‍♂️ 快速入门 了解如何操作。

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

from robocorp.actions import action

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

现在您的函数就是⚡️操作了！

您现在可以通过使用 action-server start 启动Action Server并访问 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应用程序一起使用时，尝试和迭代精确的文档措辞，以获得更可预测的结果。

后果标志

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

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

执行

为了充分利用您的动作，建议使用Action Server运行它们。但也可以通过传递命名参数直接在命令行中执行

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

指南

• 请求头

API参考

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

变更日志

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