Skip to content

docs: add Atlas Cloud as an OpenAI-compatible model client#7847

Open
lucaszhu-hue wants to merge 1 commit into
microsoft:mainfrom
lucaszhu-hue:feat/atlascloud-docs
Open

docs: add Atlas Cloud as an OpenAI-compatible model client#7847
lucaszhu-hue wants to merge 1 commit into
microsoft:mainfrom
lucaszhu-hue:feat/atlascloud-docs

Conversation

@lucaszhu-hue

Copy link
Copy Markdown

Summary

Atlas Cloud exposes an OpenAI-compatible API, so it works with AutoGen's existing OpenAIChatCompletionClient simply by setting base_url — no new client implementation is required. This PR documents that path.

  • models.ipynb — adds an "Atlas Cloud (experimental)" section to the AgentChat Models tutorial, modeled on the existing Gemini and Llama API examples. It shows base_url="https://api.atlascloud.ai/v1", an env-var api_key (ATLAS_CLOUD_API_KEY, no hard-coded secret), and an explicit model_info (since Atlas serves third-party models), plus a note to give reasoning models such as deepseek-ai/deepseek-v4-pro enough max_tokens.
  • README.md — one factual sentence in the Extensions API description noting OpenAI-compatible endpoints like Atlas Cloud can be used directly via OpenAIChatCompletionClient, linking back to the tutorial.

Docs-only, no code or package version changes. I deliberately kept this to documentation rather than adding a new client, since OpenAIChatCompletionClient already covers OpenAI-compatible providers.

Validation

  • The exact tutorial snippet was run against the live Atlas Cloud endpoint using the real autogen_ext.models.openai.OpenAIChatCompletionClient:
    • model="deepseek-ai/deepseek-v4-pro", base_url="https://api.atlascloud.ai/v1" → response "The capital of France is Paris.", finish_reason=stop.
  • Notebook validated with nbformat.validate (valid, 37 cells).

🤝 Partnership & contact

This PR comes from the Atlas Cloud team. Beyond the integration above, we'd love to explore a closer collaboration with AutoGen — for example co-marketing or a featured integration.

If that sounds interesting, reach out anytime:

And of course, happy to revise this PR to match your project's conventions — just leave a comment. 🙌

Atlas Cloud (https://www.atlascloud.ai) exposes an OpenAI-compatible API, so
it works with the existing OpenAIChatCompletionClient by setting base_url —
no new client implementation is needed.

- add an "Atlas Cloud (experimental)" section to the Models tutorial
  (models.ipynb), modeled on the existing Gemini / Llama API examples:
  base_url + env-var api_key + explicit model_info, with a note about giving
  reasoning models (e.g. deepseek-ai/deepseek-v4-pro) enough max_tokens
- mention Atlas Cloud as an OpenAI-compatible option in the README
  Extensions API description, linking to the tutorial

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@lucaszhu-hue

Copy link
Copy Markdown
Author

@microsoft-github-policy-service agree [company="AtlasCloud"]

@lucaszhu-hue

Copy link
Copy Markdown
Author

@microsoft-github-policy-service agree company="AtlasCloud"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant