Skip to content

Quick Start

Get up and running with AG2 in a few minutes. You'll install the framework, configure a model provider, and build your first agent — then give it a tool.

1. Install AG2#

Install AG2 with the extra for your model provider:

pip install "ag2[openai]"

pip install "ag2[anthropic]"

pip install "ag2[gemini]"

Then export your provider's API key:

export OPENAI_API_KEY="your-api-key"

export ANTHROPIC_API_KEY="your-api-key"

export GEMINI_API_KEY="your-api-key"

2. Build your first agent#

AG2 is async throughout, so the example runs inside an async function driven by asyncio.run. Agent.ask(...) starts a turn and returns an AgentReply; read the text with reply.body.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
import asyncio
from ag2 import Agent
from ag2.config import OpenAIConfig

agent = Agent(
    "assistant",
    prompt="You are a helpful assistant.",
    config=OpenAIConfig("gpt-4o-mini"),
)

async def main() -> None:
    reply = await agent.ask("Give me one sentence about AG2.")
    print(reply.body)

asyncio.run(main())

To continue the same conversation, call ask again on the reply — it preserves context and history:

1
2
3
4
async def main() -> None:
    reply = await agent.ask("Give me one sentence about AG2.")
    follow_up = await reply.ask("Now make it shorter.")
    print(follow_up.body)

3. Give your agent a tool#

Decorate a plain Python function with @tool and pass it to the agent. AG2 manages the full tool-calling lifecycle — the model decides when to call it, AG2 executes it, and feeds the result back.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
import asyncio
from ag2 import Agent, tool
from ag2.config import OpenAIConfig

@tool
async def get_weather(city: str) -> str:
    """Return the current weather for a city."""
    return f"It's sunny in {city}."

agent = Agent(
    "assistant",
    prompt="Use tools when helpful.",
    config=OpenAIConfig("gpt-4o-mini"),
    tools=[get_weather],
)

async def main() -> None:
    reply = await agent.ask("What's the weather in Paris?")
    print(reply.body)

asyncio.run(main())

Next steps#