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.

fix: python quickstart snippet

angrybaybladedf8f1b740416
diff --git a/fern/docs/get-started/quickstart.mdx b/fern/docs/get-started/quickstart.mdx
index 40698f74c..db74cf3f1 100644
--- a/fern/docs/get-started/quickstart.mdx
+++ b/fern/docs/get-started/quickstart.mdx
@@ -67,14 +67,19 @@ from openai import OpenAI
openai = OpenAI()
composio = Composio()
-
user_id = "[email protected]"
-connection_request = composio.toolkits.authorize(user_id, "gmail")
-print(f"πŸ”— Visit the URL to authorize:\nπŸ‘‰ {connection.redirect_url}")
+
+# Initialize connection request
+connection_request = composio.toolkits.authorize(user_id=user_id, toolkit="gmail")
+print(f"πŸ”— Visit the URL to authorize:\nπŸ‘‰ {connection_request.redirect_url}")
# wait for the connection to be active
connection_request.wait_for_connection()
+# Fetch tools
+tools = composio.tools.get(user_id=user_id, toolkits=["GMAIL"])
+
+# Invoke agent
completion = openai.chat.completions.create(
model="gpt-4o",
messages=[
@@ -86,7 +91,9 @@ completion = openai.chat.completions.create(
],
tools=tools,
)
-result = composio.provider.handle_tool_call(user_id=user_id, response=completion)
+
+# Handle Result from tool call
+result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
print(result)
```
</Tab>
diff --git a/python/composio/core/models/tools.py b/python/composio/core/models/tools.py
index ab02d5081..e63cbc630 100644
--- a/python/composio/core/models/tools.py
+++ b/python/composio/core/models/tools.py
@@ -169,7 +169,7 @@ class Tools(Resource, t.Generic[TProvider]):
self,
user_id: str,
*,
- slug: t.Optional[str] = None,
+ slug: str,
modifiers: t.Optional[Modifiers] = None,
):
"""Get tool by slug"""
@@ -179,7 +179,7 @@ class Tools(Resource, t.Generic[TProvider]):
self,
user_id: str,
*,
- tools: t.Optional[list[str]] = None,
+ tools: list[str],
modifiers: t.Optional[Modifiers] = None,
):
"""Get tools by tool slugs"""
@@ -189,7 +189,7 @@ class Tools(Resource, t.Generic[TProvider]):
self,
user_id: str,
*,
- toolkits: t.Optional[list[str]] = None,
+ toolkits: list[str],
modifiers: t.Optional[Modifiers] = None,
):
"""Get tools by toolkit slugs (Only important tools are returned)"""
@@ -199,11 +199,21 @@ class Tools(Resource, t.Generic[TProvider]):
self,
user_id: str,
*,
+ search: str,
+ modifiers: t.Optional[Modifiers] = None,
+ ):
+ """Search tool by search term"""
+
+ @t.overload
+ def get(
+ self,
+ user_id: str,
+ *,
+ toolkits: list[str],
search: t.Optional[str] = None,
- toolkits: t.Optional[list[str]] = None,
modifiers: t.Optional[Modifiers] = None,
):
- """Search tool by search term and/or toolkit slugs"""
+ """Get tool by search term and/or toolkit slugs and search term"""
def get(
self,