mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
Python: Fix tool normalization and provider sample consolidation (#3953)
* Fix tool normalization and provider samples - restore callable/single-tool normalization paths and unset tool-choice behavior\n- consolidate and expand chat/provider samples (OpenAI/Azure/Anthropic/Ollama/Bedrock)\n- migrate Bedrock lazy import surface to agent_framework.amazon and move provider samples Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * small fix in sample * Finalize provider, samples, and core cleanup Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix CopilotTool passthrough in agent Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix link --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
committed by
GitHub
Unverified
parent
ed113f941c
commit
aab621f5eb
@@ -10,6 +10,21 @@ We use [ruff](https://github.com/astral-sh/ruff) for both linting and formatting
|
||||
- **Target Python version**: 3.10+
|
||||
- **Google-style docstrings**: All public functions, classes, and modules should have docstrings following Google conventions
|
||||
|
||||
### Module Docstrings
|
||||
|
||||
Public modules must include a module-level docstring, including `__init__.py` files.
|
||||
|
||||
- Namespace-style `__init__.py` modules (for example under `agent_framework/<provider>/`) should use a structured
|
||||
docstring that includes:
|
||||
- A one-line summary of the namespace
|
||||
- A short "This module lazily re-exports objects from:" section that lists only pip install package names
|
||||
(for example `agent-framework-a2a`)
|
||||
- A short "Supported classes:" (or "Supported classes and functions:") section
|
||||
- The main `agent_framework/__init__.py` should include a concise background-oriented docstring rather than a long
|
||||
per-symbol list.
|
||||
- Core modules with broad surface area, including `agent_framework/exceptions.py` and
|
||||
`agent_framework/observability.py`, should always have explicit module docstrings.
|
||||
|
||||
## Type Annotations
|
||||
|
||||
### Future Annotations
|
||||
|
||||
Reference in New Issue
Block a user