composio-langchain 0.5.38rc2

Use Composio to get an array of tools with your LangChain agent.

🦜🔗 Using Composio With LangChain

Integrate Composio with LangChain agents to allow them to interact seamlessly with external apps, enhancing their functionality and reach.

Goal

• Star a repository on GitHub using natural language commands through a LangChain Agent.

Installation and Setup

Ensure you have the necessary packages installed and connect your GitHub account to allow your agents to utilize GitHub functionalities.

# Install Composio LangChain package
pip install composio-langchain

# Connect your GitHub account
composio-cli add github

# View available applications you can connect with
composio-cli show-apps

Usage Steps

1. Import Base Packages

Prepare your environment by initializing necessary imports from LangChain and setting up your agent.

from langchain.agents import create_openai_functions_agent, AgentExecutor
from langchain import hub
from langchain_openai import ChatOpenAI

# Initialize LangChain OpenAI Chat
llm = ChatOpenAI()

# Pull the agent prompt configuration
prompt = hub.pull("hwchase17/openai-functions-agent")

2. Fetch GitHub LangChain Tools via Composio

Access GitHub tools provided by Composio for LangChain.

from composio_langchain import ComposioToolSet, Action, App

# Initialize the toolset for GitHub
tools = ComposioToolSet(apps=[App.GITHUB])

3. Execute the Agent

Configure and execute the agent to perform tasks such as starring a repository on GitHub.

task = "Star a repo composiohq/composio on GitHub"

# Create and set up the agent
agent = create_openai_functions_agent(llm, tools, prompt)
agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)

# Execute the task
agent_executor.invoke({"input": task})

4. Check Response

Validate the execution and response from the agent to ensure the task was completed successfully.

> Entering new AgentExecutor chain...
> Invoking: `github_star_repo` with `{'owner': 'composiohq', 'repo': 'composio'}`
> {'execution_details': {'executed': True}, 'response_data': ''}
> I have successfully starred the repository composiohq/composio on GitHub.

Advanced Configuration

• Filter Specific Actions: Limit the actions an agent can execute.

# Filter to only allow creating issues on GitHub
toolsGithubCreateIssue = ComposioToolSet(actions=[Action.GITHUB_CREATE_ISSUE])

• Filter Specific Apps: Restrict the tools an agent can use.

# Allow usage of Asana and GitHub only
toolsAsanaGithub = ComposioToolSet(apps=[App.ASANA, App.GITHUB])