mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
Eduard van Valkenburg
cc0cfaaac8
* Python: fix OpenAI Azure routing and provider samples Prefer OpenAI when OPENAI_API_KEY is present unless Azure is explicitly requested. Clarify constructor docs, keep deprecated Azure wrappers compatible with stricter settings validation, and refresh the provider samples and tests to use the current client patterns. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix bandit * Python: align OpenAI embedding Azure routing Extend the shared OpenAI-vs-Azure routing and credential behavior to the embedding client, add Azure embedding regression coverage, and refresh the embedding samples to use the generic client path. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: fix embedding client pyright check Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: thin OpenAI embedding wrapper Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: document embedding overload routing Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: fix callable OpenAI key routing Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: fix Azure credential routing tests Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: address OpenAI review feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: narrow Azure routing markers Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: refine OpenAI model fallback order Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: narrow Azure deployment docs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: remove embedding routing wording Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: run embedding Azure integration tests Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * changed variable name * Python: expand OpenAI package README Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * clarified readme * Python: fix Azure OpenAI integration setup Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Python: correct Azure integration env mapping Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * updated code to fix int tests * test updates * test fix * fix test setup * updates to tests and setup * remove openai assistants int tests * improvements in int tests * fix env var * fix env vars * fix azure responses test * trigger actions --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# AGENTS.md — agent-framework-openai
|
|
|
|
OpenAI integration package for Agent Framework. Contains OpenAI Responses API and Chat Completions API clients.
|
|
|
|
## Package Structure
|
|
|
|
```
|
|
agent_framework_openai/
|
|
├── __init__.py # Public API exports
|
|
├── _chat_client.py # OpenAIChatClient (Responses API) + RawOpenAIChatClient
|
|
├── _chat_completion_client.py # OpenAIChatCompletionClient (Chat Completions API) + RawOpenAIChatCompletionClient
|
|
├── _embedding_client.py # OpenAIEmbeddingClient
|
|
├── _exceptions.py # OpenAI-specific exceptions
|
|
├── _shared.py # OpenAIBase, OpenAIConfigMixin, OpenAISettings
|
|
├── _assistants_client.py # OpenAIAssistantsClient (DEPRECATED)
|
|
└── _assistant_provider.py # OpenAIAssistantProvider (DEPRECATED)
|
|
```
|
|
|
|
## Key Classes
|
|
|
|
| Class | API | Status |
|
|
|---|---|---|
|
|
| `OpenAIChatClient` | Responses API | Primary |
|
|
| `OpenAIChatCompletionClient` | Chat Completions API | Primary |
|
|
| `OpenAIEmbeddingClient` | Embeddings API | Primary |
|
|
| `OpenAIAssistantsClient` | Assistants API | Deprecated |
|
|
|
|
All clients follow the Raw + Full-Featured pattern (e.g., `RawOpenAIChatClient` + `OpenAIChatClient`).
|
|
|
|
The generic OpenAI clients support both OpenAI and Azure OpenAI routing. Precedence is:
|
|
explicit Azure inputs (`credential`, `azure_endpoint`, `api_version`) → OpenAI API key
|
|
(`OPENAI_API_KEY`) → Azure environment fallback (`AZURE_OPENAI_*`).
|
|
|
|
## Dependencies
|
|
|
|
- `agent-framework-core` — core abstractions
|
|
- `openai` — OpenAI Python SDK
|
|
- `packaging` — version checking
|