> ## Documentation Index
> Fetch the complete documentation index at: https://docs.radium.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# AG2

> Connect AG2 agents to Radium through OpenAIConfig

<Error>
  This page contains an unverified test date marked in <span style="color:red">red</span>. Needs verification (Vijay, Adam, Alex, Product/Legal).
</Error>

# AG2

AG2 1.x, the successor to AutoGen, supports OpenAI-compatible endpoints through `OpenAIConfig`. This guide uses the current async `ag2.Agent` API.

## Before you start

You need Python 3.10 or newer, a Radium API key, and a terminal or PowerShell window.

## 1. Create a project and install AG2

<CodeGroup>
  ```bash macOS or Linux theme={null}
  mkdir radium-ag2 && cd radium-ag2
  python3 -m venv .venv
  source .venv/bin/activate
  python -m pip install "ag2[openai]"
  ```

  ```powershell Windows PowerShell theme={null}
  mkdir radium-ag2; cd radium-ag2
  py -m venv .venv
  .venv\Scripts\Activate.ps1
  python -m pip install "ag2[openai]"
  ```
</CodeGroup>

## 2. Set your Radium credentials

<CodeGroup>
  ```bash macOS or Linux theme={null}
  export RADIUM_API_KEY="your-radium-api-key"
  export RADIUM_MODEL="hal-1.0"
  ```

  ```powershell Windows PowerShell theme={null}
  $env:RADIUM_API_KEY = "your-radium-api-key"
  $env:RADIUM_MODEL = "hal-1.0"
  ```
</CodeGroup>

## 3. Create main.py

```python theme={null}
import asyncio
import os
from ag2 import Agent
from ag2.config import OpenAIConfig

api_key = os.getenv("RADIUM_API_KEY")
if not api_key:
    raise SystemExit("Set RADIUM_API_KEY before running this program.")

async def main() -> None:
    assistant = Agent(
        "radium_assistant",
        prompt="Follow the user's instruction exactly.",
        config=OpenAIConfig(
            model=os.getenv("RADIUM_MODEL", "hal-1.0"),
            api_key=api_key,
            base_url="https://api.radium.cloud/v1",
            max_tokens=512,
            temperature=0,
            timeout=90,
        ),
    )
    reply = await assistant.ask("Reply with exactly: Radium connected.")
    if not reply.body or not reply.body.strip():
        raise RuntimeError("Radium returned no visible text.")
    print(f"RADIUM_RESPONSE: {reply.body.strip()}")

asyncio.run(main())
```

<Note>
  This connection example does not enable code-execution tools.
</Note>

## 4. Run it

```bash theme={null}
python main.py
```

Expected output:

```
RADIUM_RESPONSE: Radium connected.
```

## Choose a model

```bash theme={null}
export RADIUM_MODEL="tycho-1.0"  # or hal-1.0 or clarke-1.0
python main.py
```

## Migrate an existing AG2 agent

Create a Radium configuration and pass it to the agent:

```python theme={null}
config = OpenAIConfig(
    model="hal-1.0",
    api_key=os.environ["RADIUM_API_KEY"],
    base_url="https://api.radium.cloud/v1",
    max_tokens=512,
)
agent = Agent("radium_assistant", config=config)
```

AG2 1.x removed the legacy `autogen.AssistantAgent` interface. If an older project imports `autogen`, it uses AG2 Classic and needs either the classic configuration format or a migration to the current API shown here.

## Troubleshooting

| Problem | Fix |
| - | - |
| `ImportError` for `autogen` | Follow the current `ag2.Agent` imports shown above |
| Authentication errors | Set the Radium key in the active terminal |
| `404` | Check the base URL and model ID |
| Code execution concerns | Do not add execution tools until they have been reviewed and sandboxed |

## Validation

<Check>
  These instructions were verified with Python 3.12.7 and `ag2[openai]==1.0.2` on <span style="color:red">August 20, 2026</span>. You do not need that exact package version.
</Check>

Text generation and callable-tool execution passed with `hal-1.0`, `clarke-1.0`, and `tycho-1.0`.

## Next steps

<CardGroup cols={2}>
  <Card title="API quickstart" icon="bolt" href="/quickstart">Call Radium directly</Card>
  <Card title="Tool calling" icon="wrench" href="/core-concepts/tool-calling">The tool\_use and tool\_result contract</Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.