Skip to content

Commit 995bed9

Browse files
nikhilNavanikhilNava
authored
Merge branch 'main' into nikhilc/logging
2 parents 1414e89 + b255a17 commit 995bed9

File tree

20 files changed

+884
-211
lines changed

20 files changed

+884
-211
lines changed

‎.github/ISSUE_TEMPLATE/bug_report.yml‎

Lines changed: 146 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,146 @@
1+
name: Bug Report
2+
description: Report an issue with the Agent365 Python SDK.
3+
title: "[BUG] - [short description]"
4+
labels: ["bug"]
5+
assignees: []
6+
7+
body:
8+
- type: markdown
9+
attributes:
10+
value: |
11+
## Bug Report
12+
13+
Thank you for reporting a bug in the Agent365 Python SDK! Please fill out the following information to help us diagnose and fix the issue.
14+
15+
- type: input
16+
attributes:
17+
label: "Bug Description"
18+
description: "Provide a clear and concise description of the bug."
19+
placeholder: "e.g., Agent runtime throws TypeError when processing tool responses, or observability module fails to emit telemetry events."
20+
required: true
21+
22+
- type: textarea
23+
attributes:
24+
label: "Steps to Reproduce"
25+
description: "List the steps to reproduce the behavior. Include code snippets if possible."
26+
placeholder: |
27+
e.g.,
28+
1. Import microsoft_agents_a365.runtime
29+
2. Create an agent with custom tools
30+
3. Call agent.process_activity() with a specific message
31+
4. Observe error in console
32+
value: |
33+
1.
34+
2.
35+
3.
36+
required: true
37+
38+
- type: textarea
39+
attributes:
40+
label: "Expected Behavior"
41+
description: "What did you expect to happen?"
42+
placeholder: "e.g., The agent should process the tool response and return a successful activity without errors."
43+
required: true
44+
45+
- type: textarea
46+
attributes:
47+
label: "Actual Behavior"
48+
description: "What actually happened? Include error messages, stack traces, or unexpected output."
49+
placeholder: |
50+
e.g.,
51+
TypeError: 'NoneType' object is not subscriptable
52+
File "microsoft_agents_a365/runtime/agent.py", line 123, in process_activity
53+
required: true
54+
55+
- type: dropdown
56+
attributes:
57+
label: "Affected SDK Component"
58+
description: "Which Agent365 SDK package is affected?"
59+
options:
60+
- microsoft-agents-a365-runtime
61+
- microsoft-agents-a365-tooling
62+
- microsoft-agents-a365-observability-core
63+
- microsoft-agents-a365-observability-extensions-langchain
64+
- microsoft-agents-a365-observability-extensions-openai
65+
- microsoft-agents-a365-observability-extensions-semantickernel
66+
- microsoft-agents-a365-tooling-extensions-agentframework
67+
- microsoft-agents-a365-tooling-extensions-azureaifoundry
68+
- microsoft-agents-a365-tooling-extensions-openai
69+
- microsoft-agents-a365-tooling-extensions-semantickernel
70+
- microsoft-agents-a365-notifications
71+
- Not sure / Multiple components
72+
required: true
73+
74+
- type: input
75+
attributes:
76+
label: "SDK Version"
77+
description: "What version of the Agent365 SDK are you using? (Run: pip show microsoft-agents-a365-runtime)"
78+
placeholder: "e.g., 0.1.0 or 0.1.0.dev5"
79+
required: true
80+
81+
- type: input
82+
attributes:
83+
label: "Python Version"
84+
description: "What version of Python are you using? (Run: python --version)"
85+
placeholder: "e.g., Python 3.11.5 or Python 3.12.0"
86+
required: true
87+
88+
- type: dropdown
89+
attributes:
90+
label: "Operating System"
91+
description: "What operating system are you running on?"
92+
options:
93+
- Windows
94+
- macOS
95+
- Linux (Ubuntu)
96+
- Linux (other distribution)
97+
- Azure (Container Apps / App Service)
98+
- Other
99+
required: true
100+
101+
- type: textarea
102+
attributes:
103+
label: "Environment Details"
104+
description: "Additional environment information (virtual environment, container, cloud service, etc.)"
105+
placeholder: |
106+
e.g.,
107+
- Running in Docker container
108+
- Deployed on Azure Container Apps
109+
- Using venv virtual environment
110+
- Running in GitHub Codespaces
111+
required: false
112+
113+
- type: textarea
114+
attributes:
115+
label: "Code Sample (Optional)"
116+
description: "Provide a minimal code sample that reproduces the issue."
117+
placeholder: |
118+
```python
119+
from microsoft_agents_a365.runtime import Agent
120+
121+
# Your code here that reproduces the bug
122+
agent = Agent(...)
123+
```
124+
required: false
125+
126+
- type: textarea
127+
attributes:
128+
label: "Additional Context"
129+
description: "Add any other context, logs, stack traces, or screenshots that might help."
130+
placeholder: |
131+
e.g.,
132+
- Full stack trace
133+
- Relevant log output
134+
- Related issues or discussions
135+
- Workarounds attempted
136+
required: false
137+
138+
- type: checkboxes
139+
attributes:
140+
label: "Impact"
141+
description: "How does this bug affect your work?"
142+
options:
143+
- label: Blocks development completely
144+
- label: Blocks specific feature implementation
145+
- label: Has a workaround but impacts productivity
146+
- label: Minor issue with minimal impact

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# .github/ISSUE_TEMPLATE/config.yml
2+
blank_issues_enabled: false
3+
contact_links:
4+
- name: 📚 Documentation
5+
url: https://github.com/microsoft/Agent365-python/blob/main/README.md
6+
about: Check the documentation for guides, API references, and examples
7+
- name: 💬 Discussions
8+
url: https://github.com/microsoft/Agent365-python/discussions
9+
about: Ask questions, share ideas, and engage with the community
10+
- name: ⚡ Quick Start Guide
11+
url: https://github.com/microsoft/Agent365-python/blob/main/README.md#getting-started
12+
about: Get started with the Agent365 Python SDK
13+
- name: 🔒 Security Vulnerability
14+
url: https://github.com/microsoft/Agent365-python/security/advisories/new
15+
about: Report security vulnerabilities privately (do not create public issues)

‎.github/ISSUE_TEMPLATE/feature_request.yml‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
name: Feature Request
2+
description: Suggest a new feature or improvement for the Agent365 Python SDK.
3+
title: "[FEATURE] - [short description]"
4+
labels: ["enhancement"]
5+
assignees: []
6+
7+
body:
8+
- type: markdown
9+
attributes:
10+
value: |
11+
## Feature Request
12+
13+
Thank you for suggesting a feature for the Agent365 Python SDK! Please fill out the following template to help us evaluate your request.
14+
15+
- type: input
16+
attributes:
17+
label: "Feature Description"
18+
description: "Describe the feature or enhancement you would like to see in the Agent SDK."
19+
placeholder: "e.g., Add support for streaming responses in the observability module, or support for custom authentication providers."
20+
required: true
21+
22+
- type: textarea
23+
attributes:
24+
label: "Use Case"
25+
description: "What problem does this feature solve or how would it improve agent development?"
26+
placeholder: "e.g., Streaming responses would allow real-time monitoring of agent interactions in production, improving debugging capabilities for long-running agents."
27+
required: true
28+
29+
- type: dropdown
30+
attributes:
31+
label: "Affected SDK Component"
32+
description: "Which part of the Agent365 SDK would this feature affect?"
33+
options:
34+
- microsoft-agents-a365-runtime
35+
- microsoft-agents-a365-tooling
36+
- microsoft-agents-a365-observability-core
37+
- microsoft-agents-a365-observability-extensions
38+
- microsoft-agents-a365-tooling-extensions
39+
- microsoft-agents-a365-notifications
40+
- Documentation
41+
- Multiple components
42+
- Other (specify in additional context)
43+
required: true
44+
45+
- type: input
46+
attributes:
47+
label: "Potential Impact"
48+
description: "How would this feature impact agent development or the developer experience?"
49+
placeholder: "e.g., Would reduce development time by 30% for implementing observability in production agents."
50+
required: true
51+
52+
- type: dropdown
53+
attributes:
54+
label: "Priority"
55+
description: "How important is this feature to your agent development workflow?"
56+
options:
57+
- Low - Nice to have
58+
- Medium - Would improve workflow
59+
- High - Blocking current development
60+
- Critical - Prevents SDK adoption
61+
required: true
62+
63+
- type: textarea
64+
attributes:
65+
label: "Proposed Solution (Optional)"
66+
description: "If you have ideas on how this feature could be implemented, please share them."
67+
placeholder: "e.g., Could add a StreamingObserver class that implements the Observer pattern for real-time event callbacks."
68+
required: false
69+
70+
- type: textarea
71+
attributes:
72+
label: "Alternative Solutions Considered"
73+
description: "Have you considered any workarounds or alternative approaches?"
74+
placeholder: "e.g., Currently using custom logging, but it doesn't integrate with the SDK's observability framework."
75+
required: false
76+
77+
- type: textarea
78+
attributes:
79+
label: "Additional Context"
80+
description: "Add any other information that might be helpful (code examples, related issues, external resources)."
81+
placeholder: "e.g., Related to #123, similar to feature in Microsoft.Agents .NET SDK, or example code showing the desired API."
82+
required: false

0 commit comments

Comments
 (0)