Quickstart

1
import asyncio
2
from composio import Composio
3
from agents import Agent, Runner
4
from composio_openai_agents import OpenAIAgentsProvider
5
6
composio = Composio(api_key="your-api-key", provider=OpenAIAgentsProvider())
7
8
# Id of the user in your system
9
externalUserId = "pg-test-6dadae77-9ae1-40ca-8e2e-ba2d1ad9ebc4"
10
11
# Create an auth config for gmail from the dashboard or programmatically
12
auth_config_id = "your-auth-config-id"
13
connection_request = composio.connected_accounts.link(
14
    user_id=externalUserId,
15
    auth_config_id=auth_config_id,
16
)
17
18
# Redirect user to the OAuth flow
19
redirect_url = connection_request.redirect_url
20
21
print(
22
    f"Please authorize the app by visiting this URL: {redirect_url}"
23
)  # Print the redirect url to the user
24
25
# Wait for the connection to be established
26
connected_account = connection_request.wait_for_connection()
27
print(
28
    f"Connection established successfully! Connected account id: {connected_account.id}"
29
)
30
31
# Get Gmail tools that are pre-configured
32
tools = composio.tools.get(user_id=externalUserId, tools=["GMAIL_SEND_EMAIL"])
33
34
agent = Agent(
35
    name="Email Manager", instructions="You are a helpful assistant", tools=tools
36
)
37
38
# Run the agent
39
async def main():
40
    result = await Runner.run(
41
        starting_agent=agent,
42
        input="Send an email to soham.g@composio.dev with the subject 'Hello from composio 👋🏻' and the body 'Congratulations on sending your first email using AI Agents and Composio!'",
43
    )
44
    print(result.final_output)
45
46
asyncio.run(main())