Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 22:15 UTC
Add Tool Router preload examples
Dhawal Upadhyay committed
May 6, 2026 at 16:35 UTC
9ad5705661adf73564090e6eab9e4a6e69278102
3 files changed
+240
-1
python/examples/tool_router/direct_tools_preset.py
new
+60
@@ -0,0 +1,60 @@
1
+"""
2
+Tool Router direct_tools session preset with OpenAI Agents.
3
+
4
+session_preset="direct_tools" is a shortcut for sessions where the full allowed
5
+tool set is known upfront. It disables Tool Router meta/helper tools by default
6
+and loads all tools allowed by the filters directly into session.tools() and the
7
+MCP tool list.
8
+
9
+Usage:
10
+ COMPOSIO_API_KEY=... OPENAI_API_KEY=... python examples/tool_router/direct_tools_preset.py
11
+"""
12
+
13
+import os
14
+
15
+from agents import Agent, Runner
16
+from composio_openai_agents import OpenAIAgentsProvider
17
+
18
+from composio import Composio
19
+
20
+
21
+def require_env(name: str) -> str:
22
+ value = os.environ.get(name)
23
+ if not value:
24
+ raise RuntimeError(f"Set {name} before running this example.")
25
+ return value
26
+
27
+
28
+composio = Composio(
29
+ api_key=require_env("COMPOSIO_API_KEY"),
30
+ provider=OpenAIAgentsProvider(),
31
+)
32
+require_env("OPENAI_API_KEY")
33
+
34
+session = composio.create(
35
+ user_id=f"direct-tools-example-{os.getpid()}",
36
+ session_preset="direct_tools",
37
+ toolkits=["hackernews"],
38
+ tools={"hackernews": {"enable": ["HACKERNEWS_GET_USER"]}},
39
+)
40
+
41
+tools = session.tools()
42
+print("Direct tools exposed to the agent:")
43
+for tool in tools:
44
+ print(f"- {tool.name}")
45
+
46
+agent = Agent(
47
+ name="Direct Tools Demo Agent",
48
+ instructions=(
49
+ "Use the provided direct tools. The session is configured without Tool "
50
+ "Router meta/helper tools."
51
+ ),
52
+ model=os.environ.get("OPENAI_MODEL", "gpt-4.1-mini"),
53
+ tools=tools,
54
+)
55
+
56
+result = Runner.run_sync(
57
+ agent,
58
+ 'Use the Hacker News tool to look up user "pg" and report their karma.',
59
+)
60
+print(result.final_output)
python/examples/tool_router/preload.py
new
+165
@@ -0,0 +1,165 @@
1
+"""
2
+Tool Router preload with OpenAI Agents.
3
+
4
+Shows direct tool exposure for:
5
+1. Composio tools via preload["tools"].
6
+2. SDK custom tools via preload=True on the custom tool or toolkit.
7
+3. A nested custom tool override with preload=False inside a preloaded toolkit.
8
+
9
+Usage:
10
+ COMPOSIO_API_KEY=... OPENAI_API_KEY=... python examples/tool_router/preload.py
11
+"""
12
+
13
+import os
14
+
15
+from agents import Agent, Runner
16
+from composio_openai_agents import OpenAIAgentsProvider
17
+from pydantic import BaseModel, Field
18
+
19
+from composio import Composio
20
+
21
+
22
+def require_env(name: str) -> str:
23
+ value = os.environ.get(name)
24
+ if not value:
25
+ raise RuntimeError(f"Set {name} before running this example.")
26
+ return value
27
+
28
+
29
+class UserLookupInput(BaseModel):
30
+ user_id: str = Field(description="Internal user ID, for example user-1")
31
+
32
+
33
+class TeamSearchInput(BaseModel):
34
+ team: str = Field(description="Team name to search for")
35
+
36
+
37
+class AccountInput(BaseModel):
38
+ user_id: str = Field(description="Internal user ID")
39
+
40
+
41
+INTERNAL_USERS = {
42
+ "user-1": {
43
+ "id": "user-1",
44
+ "name": "Ada Lovelace",
45
+ "email": "ada@example.com",
46
+ "team": "platform",
47
+ "plan": "enterprise",
48
+ },
49
+ "user-2": {
50
+ "id": "user-2",
51
+ "name": "Grace Hopper",
52
+ "email": "grace@example.com",
53
+ "team": "developer-tools",
54
+ "plan": "startup",
55
+ },
56
+}
57
+
58
+
59
+composio = Composio(
60
+ api_key=require_env("COMPOSIO_API_KEY"),
61
+ provider=OpenAIAgentsProvider(),
62
+)
63
+require_env("OPENAI_API_KEY")
64
+
65
+
66
+@composio.experimental.tool(
67
+ slug="LOOKUP_INTERNAL_USER",
68
+ name="Lookup internal user",
69
+ description="Look up an internal demo user profile by user ID.",
70
+ preload=True,
71
+)
72
+def lookup_internal_user(input: UserLookupInput, ctx):
73
+ user = INTERNAL_USERS.get(input.user_id)
74
+ if not user:
75
+ raise ValueError(f'User "{input.user_id}" not found')
76
+ return user
77
+
78
+
79
+@composio.experimental.tool(
80
+ slug="SEARCH_INTERNAL_USERS",
81
+ name="Search internal users",
82
+ description=(
83
+ "Search demo internal users by team. This custom tool is search-only "
84
+ "because preload is not enabled."
85
+ ),
86
+)
87
+def search_internal_users(input: TeamSearchInput, ctx):
88
+ return {
89
+ "results": [
90
+ user for user in INTERNAL_USERS.values() if user["team"] == input.team
91
+ ]
92
+ }
93
+
94
+
95
+internal_admin = composio.experimental.Toolkit(
96
+ slug="INTERNAL_ADMIN",
97
+ name="Internal admin",
98
+ description="Demo internal administration tools.",
99
+ preload=True,
100
+)
101
+
102
+
103
+@internal_admin.tool(
104
+ slug="GET_ACCOUNT_HEALTH",
105
+ name="Get account health",
106
+ description="Return internal account health details for a user.",
107
+)
108
+def get_account_health(input: AccountInput, ctx):
109
+ return {
110
+ "user_id": input.user_id,
111
+ "health": "green",
112
+ "open_incidents": 0,
113
+ "renewal_risk": "low",
114
+ }
115
+
116
+
117
+@internal_admin.tool(
118
+ slug="GET_ACCOUNT_AUDIT_LOG",
119
+ name="Get account audit log",
120
+ description=(
121
+ "Return internal account audit events. This overrides the toolkit "
122
+ "preload default and remains search-only."
123
+ ),
124
+ preload=False,
125
+)
126
+def get_account_audit_log(input: AccountInput, ctx):
127
+ return {
128
+ "user_id": input.user_id,
129
+ "events": ["login", "settings_viewed"],
130
+ }
131
+
132
+
133
+session = composio.create(
134
+ user_id=f"preload-example-{os.getpid()}",
135
+ toolkits=["hackernews"],
136
+ tools={"hackernews": {"enable": ["HACKERNEWS_GET_USER"]}},
137
+ preload={"tools": ["HACKERNEWS_GET_USER"]},
138
+ manage_connections=False,
139
+ experimental={
140
+ "custom_tools": [lookup_internal_user, search_internal_users],
141
+ "custom_toolkits": [internal_admin],
142
+ },
143
+)
144
+
145
+tools = session.tools()
146
+print("Direct tools exposed to the agent:")
147
+for tool in tools:
148
+ print(f"- {tool.name}")
149
+
150
+agent = Agent(
151
+ name="Preload Demo Agent",
152
+ instructions=(
153
+ "Use the provided direct tools. Do not search for tools first; the "
154
+ "needed tools are already loaded."
155
+ ),
156
+ model=os.environ.get("OPENAI_MODEL", "gpt-4.1-mini"),
157
+ tools=tools,
158
+)
159
+
160
+prompt = (
161
+ 'Look up Hacker News user "pg", then look up internal user user-1 and '
162
+ "their account health. Summarize the useful facts."
163
+)
164
+result = Runner.run_sync(agent, prompt)
165
+print(result.final_output)
ts/examples/tool-router/src/preload.ts
+15
-1
@@ -84,11 +84,25 @@ const getAccountHealth = experimental_createTool('GET_ACCOUNT_HEALTH', {
84
}),
85
});
86
87
+const getAccountAuditLog = experimental_createTool('GET_ACCOUNT_AUDIT_LOG', {
88
+ name: 'Get account audit log',
89
+ description:
90
+ 'Return internal account audit events. This overrides the toolkit preload default and remains search-only.',
91
+ preload: false,
92
+ inputParams: z.object({
93
+ user_id: z.string().describe('Internal user ID'),
94
+ }),
95
+ execute: async ({ user_id }) => ({
96
+ user_id,
97
+ events: ['login', 'settings_viewed'],
98
+ }),
99
+});
100
+
101
const internalAdmin = experimental_createToolkit('INTERNAL_ADMIN', {
102
name: 'Internal admin',
103
description: 'Demo internal administration tools.',
104
preload: true,
91
- tools: [getAccountHealth],
105
+ tools: [getAccountHealth, getAccountAuditLog],
106
});
107
108
const composio = new Composio({