本页面介绍来自 langchain_azure_ai.tools.

Azure Logic Apps 是一项云服务，可帮助你自动化工作流和业务流程。你可以使用 AzureLogicAppTool 从你的 LangChain 代理调用预配置的 Logic App 工作流，实现自动化、通知、数据同步和多步骤流程编排。

概述

该 AzureLogicAppTool 允许代理通过向命名触发器发送 JSON 有效载荷来触发 Azure Logic Apps 工作流。这对于自动化发送电子邮件、处理数据、调用 API 或与其他 Azure 和第三方服务集成的任务非常有用。

常见用例：

1. **电子邮件通知** - 通过 Logic App 发送警报和通知
2. **数据同步** - 在系统之间同步数据
3. **订单处理** - 触发订单履约工作流
4. **API 集成** - 通过 Logic Apps 调用外部 API
5. **审批工作流** - 启动审批流程
6. **数据转换** - 处理和转换数据
7. **多步骤自动化** - 编排复杂的业务流程

设置

安装集成包并配置你的 Azure 凭据。

安装

使用以下命令安装包 tools extra:

    pip install -U "langchain-azure-ai[tools]"
    

    uv add "langchain-azure-ai[tools]"
    

此额外包安装了必需的 azure-mgmt-logic dependency.

前提条件

使用此工具之前，你需要：

1. 一个 Azure 订阅
2. 一个至少有一个 HTTP 请求触发器的 Azure Logic App
3. 订阅 ID、资源组名称、Logic App 名称和触发器名称

凭据

该工具默认使用 DefaultAzureCredential() 它支持多种身份验证方法，包括环境变量、托管标识和交互式登录。

from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()

你也可以显式传递特定的凭据：

from azure.identity import ManagedIdentityCredential

credential = ManagedIdentityCredential()

基本用法

实例化工具

from langchain_azure_ai.tools import AzureLogicAppTool

tool = AzureLogicAppTool(
    subscription_id="<your-subscription-id>",
    resource_group="<your-resource-group>",
    logic_app_name="<your-logic-app-name>",
    trigger_name="<your-trigger-name>",
)

调用工具

# Simple text input
result = tool.invoke("Send an email notification")
print(result)

# JSON payload input
payload = {
    "email": "user@example.com",
    "subject": "Test Email",
    "message": "This is a test message from a Logic App trigger."
}
result = tool.invoke(json.dumps(payload))
print(result)

与代理一起使用

将工具传递给 create_agent.

from azure.identity import DefaultAzureCredential
from langchain.agents import create_agent
from langchain.chat_models import init_chat_model
from langchain_azure_ai.tools import AzureLogicAppTool

credential = DefaultAzureCredential()
tool = AzureLogicAppTool(
    subscription_id="<your-subscription-id>",
    resource_group="<your-resource-group>",
    logic_app_name="notification-workflow",
    trigger_name="manual_trigger",
    credential=credential,
)

agent = create_agent(
    model=init_chat_model("azure_ai:gpt-4.1", credential=credential),
    tools=[tool],
    system_prompt=(
        "You are a workflow automation assistant. Use the Logic Apps tool to trigger "
        "workflows for sending notifications, processing data, or integrating with "
        "other services when users request automation tasks."
    ),
)

配置

参数

输入格式

该工具接受以下格式的输入：

1. **纯文本** - 自动转换为 JSON，并带有 input 键
2. **JSON 字符串** - 解析后按原样发送到逻辑应用触发器

示例

# Plain text input
tool.invoke("Process this order")
# Sent as: {"input": "Process this order"}

# JSON payload

payload = {
    "orderId": "12345",
    "customerEmail": "customer@example.com",
    "items": ["item1", "item2"]
}
tool.invoke(json.dumps(payload))

响应格式

该工具返回指示成功或失败的 JSON 响应：

{
  "result": "Successfully invoked <logic-app-name>."
}

或出错时：

{
  "error": "Error invoking <logic-app-name> (HTTP_STATUS): ERROR_DETAILS"
}

API 参考

from langchain_azure_ai.tools import AzureLogicAppTool