功能

将编码函数作为智能体工具，让智能体将自定义 Python 代码作为基于流程的确定性工具，与自动化和 API 工作流一起运行。

编码函数工具可让智能体将自定义 Python 代码作为工具运行。函数封装了确定性逻辑（数据转换、计算或对外部系统的调用），智能体会在其推理需要时调用这些逻辑，然后对返回的结果进行推理。

编码函数的行为与智能体可以使用的其他基于流程的工具类似，例如 API 工作流、自动化或智能体工具。智能体将输入参数传递给函数，函数运行其 Python 代码，智能体接收结构化输出。

在 Studio Web 中创建函数。有关编写、打包和发布函数的详细信息，请参阅Functions 用户指南。

智能体如何使用函数

当某功能在您的解决方案中可用时，该功能将在 Studio Web 中的智能体定义的“工具”部分显示为可选工具。每个工具都带有描述，可帮助智能体了解其用途以及何时使用。

在运行时，智能体将输入参数传递给函数，函数执行其 Python 逻辑，结果作为结构化输出返回给智能体，用于其计划中的下一步。由于逻辑是确定性代码，因此对于相同的输入，函数会返回相同的输出，这适合于语言模型不应仅通过推理执行的精确操作。

与其他工具类型一样，编码函数支持平台的监管控制。您可以设置护栏以控制调用函数的时间和方式，并设置工具模拟以测试智能体的推理情况，而无需运行真实代码。

将函数添加为工具

您可以从可用资源中添加现有函数，也可以在不离开智能体的情况下新建函数。

1. 在“定义”面板的“工具”部分下，选择“添加工具”。
2. 选择“函数” 。
3. 添加函数：
   • 要使用现有函数，请搜索该函数或从可用资源中选择。
   • 要创建新函数，请选择“新建” 。函数创建向导将在解决方案中打开。
4. 使用系统提示描述功能的用途以及智能体应在何时使用功能。请为任何参数提供描述，以帮助智能体有效使用。

监控函数的执行

当智能体运行编码函数工具时，您可以在两个位置检查执行情况：

• 智能体追踪— 调试运行后，执行追踪记录包括函数的工具调用，显示传递给该函数的输入参数以及返回的输出。
• Orchestrator — 功能作为流程运行。在 Orchestrator 的“监控”>“作业”下，该函数与智能体的其他作业执行一起显示为作业。