Robocorp 工具包

本笔记本介绍了如何开始使用 Robocorp Action Server action 工具包和 LangChain。

Robocorp 是扩展 AI 代理、助手和副驾驶功能的更简便方法，通过自定义操作。

安装

首先，查看 Robocorp 快速入门，了解如何设置 Action Server 并创建您的 Actions。

在您的 LangChain 应用程序中，安装 langchain-robocorp 包

# Install package
%pip install --upgrade --quiet langchain-robocorp

当您按照上面的快速入门创建新的 Action Server 时。

它将创建一个包含文件的目录，包括 action.py。

我们可以添加 python 函数作为 actions，如 此处 所示。

让我们向 action.py 添加一个虚拟函数。

@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
    """
    return "75F and sunny :)"

然后我们启动服务器

action-server start

我们可以看到

Found new action: get_weather_forecast

通过访问 https://127.0.0.1:8080 上运行的服务器在本地进行测试，并使用 UI 运行该函数。

环境设置

您可以选择设置以下环境变量

• LANGSMITH_TRACING=true：启用 LangSmith 日志运行跟踪，该跟踪也可以绑定到各自的 Action Server action 运行日志。有关更多信息，请参阅 LangSmith 文档。

用法

我们启动了本地 action 服务器，如上所述，在 https://127.0.0.1:8080 上运行。

from langchain.agents import AgentExecutor, OpenAIFunctionsAgent
from langchain_core.messages import SystemMessage
from langchain_openai import ChatOpenAI
from langchain_robocorp import ActionServerToolkit

# Initialize LLM chat model
llm = ChatOpenAI(model="gpt-4", temperature=0)

# Initialize Action Server Toolkit
toolkit = ActionServerToolkit(url="https://127.0.0.1:8080", report_trace=True)
tools = toolkit.get_tools()

# Initialize Agent
system_message = SystemMessage(content="You are a helpful assistant")
prompt = OpenAIFunctionsAgent.create_prompt(system_message)
agent = OpenAIFunctionsAgent(llm=llm, prompt=prompt, tools=tools)

executor = AgentExecutor(agent=agent, tools=tools, verbose=True)

executor.invoke("What is the current weather today in San Francisco in fahrenheit?")

API 参考：AgentExecutor | OpenAIFunctionsAgent | SystemMessage | ChatOpenAI

> Entering new AgentExecutor chain...

Invoking: `robocorp_action_server_get_weather_forecast` with `{'city': 'San Francisco', 'days': 1, 'scale': 'fahrenheit'}`


"75F and sunny :)"The current weather today in San Francisco is 75F and sunny.

> Finished chain.

{'input': 'What is the current weather today in San Francisco in fahrenheit?',
 'output': 'The current weather today in San Francisco is 75F and sunny.'}

单输入工具

默认情况下，toolkit.get_tools() 将返回 actions 作为结构化工具。

要返回单输入工具，请传递一个聊天模型，用于处理输入。

# Initialize single input Action Server Toolkit
toolkit = ActionServerToolkit(url="https://127.0.0.1:8080")
tools = toolkit.get_tools(llm=llm)

相关

• 工具 概念指南
• 工具 操作指南