Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

quickstart updates

Sushmithamallesh6a10c68d5e3d
diff --git a/fern/pages/src/tool-router/quickstart.mdx b/fern/pages/src/tool-router/quickstart.mdx
index 952174f04..836e6fb54 100644
--- a/fern/pages/src/tool-router/quickstart.mdx
+++ b/fern/pages/src/tool-router/quickstart.mdx
@@ -127,10 +127,10 @@ When you run this agent, Tool Router:
<Step title="Install">
<CodeGroup>
```bash title="Python" for="python"
-pip install composio openai
+pip install composio composio-openai-agents openai-agents
```
```bash title="TypeScript" for="typescript"
-npm install @composio/core openai
+npm install @composio/core @composio/openai-agents @openai/agents
```
</CodeGroup>
</Step>
diff --git a/fern/snippets/tool-router/python/quickstart-native-openai.py b/fern/snippets/tool-router/python/quickstart-native-openai.py
index dc953a576..8317d68db 100644
--- a/fern/snippets/tool-router/python/quickstart-native-openai.py
+++ b/fern/snippets/tool-router/python/quickstart-native-openai.py
@@ -1,72 +1,40 @@
import os
-import json
from dotenv import load_dotenv
from composio import Composio
-from openai import OpenAI
+from agents import Agent, Runner, SQLiteSession
+from composio_openai_agents import OpenAIAgentsProvider
-# Load environment variables from .env file
load_dotenv()
-composio_api_key = os.environ.get("COMPOSIO_API_KEY")
-user_id = "user_123" # Your user's unique identifier
+composio = Composio(api_key=os.environ.get("COMPOSIO_API_KEY"), provider=OpenAIAgentsProvider())
+session = composio.create(user_id="user_123")
-# Initialize Composio and create a Tool Router session
-composio = Composio(api_key=composio_api_key)
-session = composio.create(user_id=user_id)
+# Get native tools from Composio
+tools = session.tools()
-# Initialize OpenAI client
-client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))
+# Create OpenAI agent with Composio tools
+agent = Agent(
+ name="AI Assistant",
+ instructions="You are a helpful assistant with access to external tools. Use the available tools to complete user requests.",
+ model="gpt-5.2",
+ tools=tools,
+)
-# Get Tool Router as a native tool
-tool_router = session.get_tool_router()
+# Create session for multi-turn conversation
+conversation_session = SQLiteSession("conversation_example")
-print("Assistant: What would you like me to do today?\n")
+print("Assistant: What would you like me to do today? Type 'exit' to end the conversation.\n")
-# Interactive loop
-messages = []
while True:
user_input = input("> ")
- if user_input == "exit":
+ if user_input.lower() == "exit":
break
- # Add user message
- messages.append({"role": "user", "content": user_input})
-
- # Get response from OpenAI
- response = client.chat.completions.create(
- model="gpt-4-turbo-preview",
- messages=messages,
- tools=[tool_router.tool],
- tool_choice="auto"
+ # Run agent with session to maintain context
+ result = Runner.run_sync(
+ starting_agent=agent,
+ input=user_input,
+ session=conversation_session,
)
- assistant_message = response.choices[0].message
- messages.append(assistant_message)
-
- # Handle tool calls
- if assistant_message.tool_calls:
- for tool_call in assistant_message.tool_calls:
- if tool_call.function.name == "composio_tool_router":
- # Execute the tool
- args = json.loads(tool_call.function.arguments)
- result = tool_router.execute(args)
-
- # Add tool result to messages
- messages.append({
- "role": "tool",
- "tool_call_id": tool_call.id,
- "content": json.dumps(result)
- })
-
- # Get final response after tool execution
- final_response = client.chat.completions.create(
- model="gpt-4-turbo-preview",
- messages=messages,
- tools=[tool_router.tool]
- )
-
- final_message = final_response.choices[0].message
- messages.append(final_message)
- print(f"Assistant: {final_message.content}\n")
- else:
- print(f"Assistant: {assistant_message.content}\n")
\ No newline at end of file
+ print(f"Assistant: {result.final_output}\n")
\ No newline at end of file
diff --git a/fern/snippets/tool-router/typescript/quickstart-native-openai.ts b/fern/snippets/tool-router/typescript/quickstart-native-openai.ts
index e74bb8130..a920250c0 100644
--- a/fern/snippets/tool-router/typescript/quickstart-native-openai.ts
+++ b/fern/snippets/tool-router/typescript/quickstart-native-openai.ts
@@ -1,75 +1,38 @@
import "dotenv/config"; // Load environment variables from .env file
import { Composio } from "@composio/core";
-import OpenAI from "openai";
+import { Agent, run, MemorySession } from "@openai/agents";
+import { OpenAIAgentsProvider } from "@composio/openai-agents";
import { createInterface } from "readline/promises";
const composioApiKey = process.env.COMPOSIO_API_KEY;
const userId = "user_123"; // Your user's unique identifier
-// Initialize Composio and create a Tool Router session
-const composio = new Composio({ apiKey: composioApiKey });
+const composio = new Composio({ apiKey: composioApiKey, provider: new OpenAIAgentsProvider() });
const session = await composio.create(userId);
-// Initialize OpenAI client
-const openai = new OpenAI({
- apiKey: process.env.OPENAI_API_KEY,
+// Get native tools from Composio
+const tools = await session.tools();
+
+// Create OpenAI agent with Composio tools
+const agent = new Agent({
+ name: "AI Assistant",
+ instructions: "You are a helpful assistant with access to external tools. Use the available tools to complete user requests.",
+ model: "gpt-5.2",
+ tools: tools,
});
-// Get Tool Router as a native tool
-const toolRouter = await session.getToolRouter();
+// Create session for multi-turn conversation
+const conversationSession = new MemorySession();
const rl = createInterface({ input: process.stdin, output: process.stdout });
-console.log("Assistant: What would you like me to do today?\n");
+console.log("Assistant: What would you like me to do today? Type 'exit' to end the conversation.\n");
-// Interactive loop
-const messages: any[] = [];
while (true) {
const userInput = await rl.question("> ");
- if (userInput === "exit") break;
-
- // Add user message
- messages.push({ role: "user", content: userInput });
-
- // Get response from OpenAI
- const response = await openai.chat.completions.create({
- model: "gpt-4-turbo-preview",
- messages: messages,
- tools: [toolRouter.tool],
- tool_choice: "auto",
- });
-
- const assistantMessage = response.choices[0].message;
- messages.push(assistantMessage);
+ if (userInput.toLowerCase() === "exit") break;
- // Handle tool calls
- if (assistantMessage.tool_calls) {
- for (const toolCall of assistantMessage.tool_calls) {
- if (toolCall.function.name === "composio_tool_router") {
- // Execute the tool
- const args = JSON.parse(toolCall.function.arguments);
- const result = await toolRouter.execute(args);
-
- // Add tool result to messages
- messages.push({
- role: "tool",
- tool_call_id: toolCall.id,
- content: JSON.stringify(result),
- });
- }
- }
-
- // Get final response after tool execution
- const finalResponse = await openai.chat.completions.create({
- model: "gpt-4-turbo-preview",
- messages: messages,
- tools: [toolRouter.tool],
- });
-
- const finalMessage = finalResponse.choices[0].message;
- messages.push(finalMessage);
- console.log(`Assistant: ${finalMessage.content}\n`);
- } else {
- console.log(`Assistant: ${assistantMessage.content}\n`);
- }
+ // Run agent with session to maintain context
+ const result = await run(agent, userInput, { session: conversationSession });
+ console.log(`Assistant: ${result.finalOutput}\n`);
}
rl.close();
\ No newline at end of file