docs: update docs of python, introduce new recipes and fix few docs linking points #233

SilentDemonSD · 2026-01-27T18:13:57Z

Overview

This PR adds a complete Python cookbook with practical recipes and enhances the SDK documentation and to include all four supported languages (Node.js/TypeScript, Python, Go, and .NET) for custom_agents.md and mcp.md in docs folder.

Changes

New Python Recipe Files (10 recipes)

custom_agents.py - Create specialized AI agents with custom prompts and behaviors
custom_providers.py - Implement custom model providers for specialized AI backends
custom_tools.py - Build custom tools to extend agent capabilities
error_handling.py - Handle errors gracefully including retries and cleanup
managing_local_files.py - AI-powered file organization using metadata
mcp_servers.py - Model Context Protocol server integration
multiple_sessions.py - Manage independent conversations simultaneously
persisting_sessions.py - Save and resume sessions across restarts
pr_visualization.py - Generate PR analytics charts using GitHub MCP Server
streaming_responses.py - Real-time response streaming patterns

New/Updated Documentation

docs/custom-agents.md - New comprehensive guide with all 4 language examples
docs/mcp.md - Added multi-language Quick Start examples
docs/getting-started.md - Updated with SessionEventType enum usage
cookbook/python/README.md - Enhanced with all recipes and quick start guide
cookbook/python/recipe/README.md - Added SessionEventType reference table
cookbook/README.md - Updated recipe listings for Python

Code Improvements

Refactored all Python recipes to use SessionEventType Enum from copilot.types

Co-ordination Points across all PRs and Issues

Some PR have some part or on the way, so can check if want to from here.

PR

refactor(python): update Python Cookbook to Async, add missing methods & Py Bug Fixes (fixes #130, #129, #118) #138 (My Previous One)
docs: Update Python cookbook examples #127 (Updated Recipes)
chore: update PR visualization example to work with latest sdk #214 (Updated pr_visualization.py)
Refactor file management script to use asyncio and correct event #225 (Updated managing_local_files.py)

Fix Issues

Some Issues were there regarding proper docs to connect different entry points of the SDK docs. Some Newcomers had a huddle in understanding .
CookBook based on Python is not working #166
[python]: Type hint on SessionConfig.model should be str rather than Literal? #169

Purpose

This co ordinated all the pr and issues into a common point of view that it is being addressed !
Review is required if it is OK and aligned with indent

* Initial plan * Wrap StreamJsonRpc exceptions with CopilotRpcException Co-authored-by: SteveSandersonMS <1101362+SteveSandersonMS@users.noreply.github.com> * Add explicit using System.IO for IOException Co-authored-by: SteveSandersonMS <1101362+SteveSandersonMS@users.noreply.github.com> * Only wrap RPC invocation calls in try-catch blocks Co-authored-by: SteveSandersonMS <1101362+SteveSandersonMS@users.noreply.github.com> * Remove implementation details from CopilotRpcException docs Co-authored-by: SteveSandersonMS <1101362+SteveSandersonMS@users.noreply.github.com> * Replace CopilotRpcException with IOException and add RPC wrapper methods Co-authored-by: SteveSandersonMS <1101362+SteveSandersonMS@users.noreply.github.com> * Catch RemoteRpcException, refactor Session.InvokeRpcAsync, remove unused using Co-authored-by: SteveSandersonMS <1101362+SteveSandersonMS@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: SteveSandersonMS <1101362+SteveSandersonMS@users.noreply.github.com>

- Remove type annotations (TYPE_CHECKING, type hints) from all 10 recipe files - Simplify function signatures for better readability - Create docs/core-concepts.md with common SDK concepts: - Architecture overview - Session lifecycle - Event types table - Error handling patterns - Custom tools, MCP, agents, providers - Simplify cookbook/python/README.md with link to core-concepts - Add new recipe files: custom_agents.py, custom_providers.py, custom_tools.py, mcp_servers.py, streaming_responses.py - Add new documentation: custom-agents.md, custom-providers.md, custom-tools.md, mcp-servers.md, streaming-responses.md - Fix requirements.txt path to local SDK - Update pyproject.toml for Python 3.13/3.14 support

…s multiple recipes and documentation updates. Added custom agents documentation and improved error handling patterns.

…hance docs

Copilot

Pull request overview

This PR adds a complete Python cookbook with 10 practical recipes and enhances SDK documentation to include all four supported languages (Node.js/TypeScript, Python, Go, and .NET) for custom agents and MCP servers. It consolidates work from multiple related PRs (#138, #127, #214, #225) and addresses documentation issues (#166, #169).

Changes:

New Python recipes: 10 comprehensive examples covering custom agents, providers, tools, error handling, file management, MCP servers, multiple sessions, persistence, PR visualization, and streaming
Multi-language documentation: Updated docs/custom-agents.md (new) and docs/mcp.md with examples in all 4 languages
SDK improvements: Enhanced .NET error handling with InvokeRpcAsync wrapper, updated Python type definitions with expanded model list and SessionEventType export

Reviewed changes

Copilot reviewed 34 out of 34 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
`python/setup.py`	Updated Python version requirement from 3.8 to 3.9
`python/pyproject.toml`	Added Python 3.13-3.14 support, upper version constraint
`python/copilot/types.py`	Exported SessionEventType, expanded model literal types
`dotnet/src/Client.cs`	Added InvokeRpcAsync wrapper for better error handling
`dotnet/src/Session.cs`	Refactored to use InvokeRpcAsync helper
`dotnet/test/SessionTests.cs`	Updated exception types from RemoteInvocationException to IOException
`dotnet/README.md`	Updated error handling examples
`docs/mcp.md`	Added multi-language quick start examples (Python, Go, .NET)
`docs/getting-started.md`	Updated SessionEventType import to use copilot.types
`docs/custom-agents.md`	New comprehensive guide with all 4 language examples
`cookbook/python/*.md`	10 new/updated recipe documentation files
`cookbook/python/recipe/*.py`	10 new recipe implementation files
`cookbook/python/recipe/requirements.txt`	Fixed SDK path reference
`cookbook/python/recipe/README.md`	Enhanced with SessionEventType reference and async patterns guide
`cookbook/python/README.md`	Complete rewrite with recipe listing and troubleshooting
`cookbook/README.md`	Updated Python recipe listings

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

python/pyproject.toml

cookbook/python/custom-agents.md

python/copilot/types.py

cookbook/python/recipe/error_handling.py

…g raised instead. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…t-sdk into py-cookbook

Copilot AI and others added 4 commits January 27, 2026 19:32

refactor: event type handling to use SessionEventType constants acros…

b8da13b

…s multiple recipes and documentation updates. Added custom agents documentation and improved error handling patterns.

docs: update README files to include installation instructions and en…

3b82986

…hance docs

SilentDemonSD requested a review from a team as a code owner January 27, 2026 18:13

Copilot AI review requested due to automatic review settings January 27, 2026 18:13

Copilot started reviewing on behalf of SilentDemonSD January 27, 2026 18:14 View session

Copilot AI reviewed Jan 27, 2026

View reviewed changes

SilentDemonSD and others added 3 commits January 27, 2026 23:50

fix: Illegal class 'NoneType' raised; will result in a TypeError bein…

6788b87

…g raised instead. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

fix: restrictive python version

a3fb3be

Merge branch 'py-cookbook' of https://github.com/SilentDemonSD/copilo…

ddc01da

…t-sdk into py-cookbook

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: update docs of python, introduce new recipes and fix few docs linking points #233

docs: update docs of python, introduce new recipes and fix few docs linking points #233

SilentDemonSD commented Jan 27, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

docs: update docs of python, introduce new recipes and fix few docs linking points #233

Are you sure you want to change the base?

docs: update docs of python, introduce new recipes and fix few docs linking points #233

Conversation

SilentDemonSD commented Jan 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Overview

Changes

New Python Recipe Files (10 recipes)

New/Updated Documentation

Code Improvements

Co-ordination Points across all PRs and Issues

Purpose

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

SilentDemonSD commented Jan 27, 2026 •

edited

Loading