templates: robocorp action server template (#15776)

---------

Co-authored-by: Rihards Gravis <rihards@gravis.lv>
Co-authored-by: Mikko Korpela <mikko@robocorp.com>

templates/robocorp-action-server/.gitignore

@@ -0,0 +1 @@
+__pycache__

templates/robocorp-action-server/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 LangChain, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

templates/robocorp-action-server/README.md

@@ -0,0 +1,81 @@
+# Langchain - Robocorp Action Server
+
+This template enables using [Robocorp Action Server](https://github.com/robocorp/robocorp) served actions as tools for an Agent.
+
+## Usage
+
+To use this package, you should first have the LangChain CLI installed:
+
+```shell
+pip install -U langchain-cli
+```
+
+To create a new LangChain project and install this as the only package, you can do:
+
+```shell
+langchain app new my-app --package robocorp-action-server
+```
+
+If you want to add this to an existing project, you can just run:
+
+```shell
+langchain app add robocorp-action-server
+```
+
+And add the following code to your `server.py` file:
+
+```python
+from robocorp_action_server import agent_executor as action_server_chain
+
+add_routes(app, action_server_chain, path="/robocorp-action-server")
+```
+
+### Running the Action Server
+
+To run the Action Server, you need to have the Robocorp Action Server installed
+
+```bash
+pip install -U robocorp-action-server
+```
+
+Then you can run the Action Server with:
+
+```bash
+action-server new
+cd ./your-project-name
+action-server start
+```
+
+### Configure LangSmith (Optional)
+
+LangSmith will help us trace, monitor and debug LangChain applications.
+LangSmith is currently in private beta, you can sign up [here](https://smith.langchain.com/).
+If you don't have access, you can skip this section
+
+```shell
+export LANGCHAIN_TRACING_V2=true
+export LANGCHAIN_API_KEY=<your-api-key>
+export LANGCHAIN_PROJECT=<your-project>  # if not specified, defaults to "default"
+```
+
+### Start LangServe instance
+
+If you are inside this directory, then you can spin up a LangServe instance directly by:
+
+```shell
+langchain serve
+```
+
+This will start the FastAPI app with a server is running locally at
+[http://localhost:8000](http://localhost:8000)
+
+We can see all templates at [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)
+We can access the playground at [http://127.0.0.1:8000/robocorp-action-server/playground](http://127.0.0.1:8000/robocorp-action-server/playground)
+
+We can access the template from code with:
+
+```python
+from langserve.client import RemoteRunnable
+
+runnable = RemoteRunnable("http://localhost:8000/robocorp-action-server")
+```

templates/robocorp-action-server/pyproject.toml

@@ -0,0 +1,25 @@
+[tool.poetry]
+name = "robocorp-action-server"
+version = "0.0.1"
+description = ""
+authors = ["Robocorp Technologies <info@robocorp.com>"]
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = ">=3.8.1,<4.0"
+langchain = "^0.1"
+langchain-openai = ">=0.0.2,<0.1"
+langchain-robocorp = ">=0.0.1,<0.1"
+
+[tool.poetry.group.dev.dependencies]
+langchain-cli = ">=0.0.20"
+fastapi = "^0.104.0"
+sse-starlette = "^1.6.5"
+
+[tool.langserve]
+export_module = "robocorp_action_server"
+export_attr = "agent_executor"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

templates/robocorp-action-server/robocorp_action_server/__init__.py

@@ -0,0 +1,3 @@
+from robocorp_action_server.agent import agent_executor
+
+__all__ = ["agent_executor"]

templates/robocorp-action-server/robocorp_action_server/agent.py

@@ -0,0 +1,36 @@
+from langchain.agents import AgentExecutor, OpenAIFunctionsAgent
+from langchain_core.messages import SystemMessage
+from langchain_core.pydantic_v1 import BaseModel
+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="http://localhost:8080")
+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,
+)
+
+# Initialize Agent executor
+agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
+
+
+# Typings for Langserve playground
+class Input(BaseModel):
+    input: str
+
+
+class Output(BaseModel):
+    output: str
+
+
+agent_executor = agent_executor.with_types(input_type=Input, output_type=Output)  # type: ignore[arg-type, assignment]