{"name":"DA-Forge: Streamlining Declarative Agent Creation for Copilot Notebooks","description":"DA-Forge is a Python-based tool by Microsoft designed to automate the creation and deployment of Declarative Agents for Copilot Notebooks. It significantly reduces the manual effort and time required to set up AI assistants with specific grounding references, transforming an 85-minute process into just a few minutes. This tool is essential for developers and researchers working with Copilot Notebooks and Declarative Agents.","github":"https://github.com/microsoft/da-forge","url":"https://osrepos.com/repo/microsoft-da-forge","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/microsoft-da-forge","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/microsoft-da-forge.md","json":"https://osrepos.com/repo/microsoft-da-forge.json","topics":["Python","Microsoft 365","Copilot","AI Agents","Automation","Development Tools","GitHub","CLI"],"keywords":["Python","Microsoft 365","Copilot","AI Agents","Automation","Development Tools","GitHub","CLI"],"stars":null,"summary":"DA-Forge is a Python-based tool by Microsoft designed to automate the creation and deployment of Declarative Agents for Copilot Notebooks. It significantly reduces the manual effort and time required to set up AI assistants with specific grounding references, transforming an 85-minute process into just a few minutes. This tool is essential for developers and researchers working with Copilot Notebooks and Declarative Agents.","content":"## Introduction\n\nDA-Forge is an innovative open-source tool developed by Microsoft, designed to significantly streamline the creation and deployment of Declarative Agents for Copilot Notebooks. This Python-based utility automates a complex, multi-step process, enabling developers and researchers to ground AI agents with specific references like emails, meetings, files, and webpages in a matter of seconds. It transforms what was previously a time-consuming and error-prone manual task into an efficient, one-command operation.\n\nFor more details, visit the official repository: [microsoft/da-forge](https://github.com/microsoft/da-forge){target=\"_blank\"}\n\n## Why Use It and Key Benefits\n\nThe process of creating Declarative Agents as a proxy for Copilot Notebooks for research or development purposes traditionally involves significant manual effort and time. Developers often face challenges such as:\n\n*   **Manual Manifest Creation:** Generating complex manifest files with specific formats can take around 40 minutes.\n*   **Unique ID Extraction:** Manually extracting and formatting unique IDs from files, emails, and meetings uploaded as Notebook references can consume another 30 minutes.\n*   **Special Formatting Requirements:** Each capability type has its own ID structure and JSON schema, adding to the complexity.\n*   **DA Initiation and Sideloading:** Multiple manual steps for agent initiation and sideloading are prone to errors and take about 15 minutes.\n\nCollectively, these steps can amount to approximately 85 minutes per agent, coupled with a high error rate.\n\nDA-Forge provides a robust solution by automating this entire process. By simply extracting the socket JSON from your Copilot Notebook configuration, you can deploy a Declarative Agent in roughly 2 minutes. This drastic reduction in deployment time, from 85 minutes to just 2, makes DA-Forge an invaluable tool.\n\nKey features and benefits include:\n\n*   **Zero External Dependencies:** Built purely with Python's standard library, ensuring minimal overhead and easy integration.\n*   **Automated Manifest Generation:** Generates manifest files from templates with automatic GUID generation.\n*   **Smart Capability Injection:** Automatically categorizes and injects capabilities, handling both regular and experimental types.\n*   **One-Command Deployment:** Simplifies the entire workflow, from creation and revision to zipping and sideloading, into a single command.\n*   **Socket-Based Configuration:** Separates grounding data from boilerplate, allowing for cleaner and more manageable configurations.\n\n## Installation\n\nTo get started with DA-Forge, follow these installation steps.\n\n### Prerequisites\n\n*   Python 3.10+\n*   [Teams Toolkit CLI](https://learn.microsoft.com/microsoftteams/platform/toolkit/teams-toolkit-cli){target=\"_blank\"} for sideloading\n\n### Installation Options\n\n**Option 1: Install from GitHub (Recommended)**\n\nbash\n# Install latest release\npip install git+https://github.com/microsoft/da-forge.git\n\n# Or install a specific version\npip install git+https://github.com/microsoft/da-forge.git@v1.0.0\n\n\n**Option 2: Install from Source (for development)**\n\nbash\n# Clone the repository\ngit clone https://github.com/microsoft/da-forge.git\ncd da-forge\n\n# Install in editable mode\npip install -e .\n\n\nAfter installation, the `da-forge` command will be available globally.\n\n## Examples\n\nHere’s how to use DA-Forge to deploy your Declarative Agents.\n\n### Step 1: Set up your project\n\nbash\nmkdir my-agents\ncd my-agents\nmkdir sockets\n\n\n### Step 2: Extract and save socket JSON\n\nDetailed instructions for extracting the socket JSON from your Copilot Notebook configuration can be found in the official documentation: [docs/capabilities.md](https://github.com/microsoft/da-forge/blob/main/docs/capabilities.md){target=\"_blank\"}.\n\nSave the extracted socket JSON to `sockets/my-agent.json`.\n\n### Step 3: Deploy your agent\n\nbash\nda-forge deploy my-agent\n\n\nThe tool will automatically perform the following actions:\n\n*   Use bundled templates from the package.\n*   Create `raw_manifests/` with generated manifest files.\n*   Create `zipped_manifests/` with the deployment package.\n*   Sideload to Teams (or skip with `--skip-sideload`).\n\nYour Declarative Agent will then be deployed to Teams with all the grounding context from your Copilot Notebook.\n\n### CLI Commands\n\n**Deploy an agent:**\n\nbash\nda-forge deploy <name> [--description TEXT] [--instruction TEXT] [--skip-sideload]\n\n\nExamples:\n\nbash\n# Basic deployment\nda-forge deploy my-copilot\n\n# With custom description and instructions\nda-forge deploy my-copilot --description \"Email assistant\" --instruction \"Help with emails\"\n\n# Skip sideloading (just create package)\nda-forge deploy my-copilot --skip-sideload\n\n\n**List available agents:**\n\nbash\nda-forge list\n\n\nThis command shows all socket files located in the `sockets/` folder.\n\n## Links\n\n*   **Official GitHub Repository:** [microsoft/da-forge](https://github.com/microsoft/da-forge){target=\"_blank\"}\n*   **Teams Toolkit CLI:** [Learn more about Teams Toolkit CLI](https://learn.microsoft.com/microsoftteams/platform/toolkit/teams-toolkit-cli){target=\"_blank\"}\n*   **Capabilities Documentation:** [Detailed guide on extracting socket JSON](https://github.com/microsoft/da-forge/blob/main/docs/capabilities.md){target=\"_blank\"}\n*   **Development Documentation:** [Instructions for development setup, testing, and formatting](https://github.com/microsoft/da-forge/blob/main/docs/development.md){target=\"_blank\"}\n*   **License:** [MIT License](https://github.com/microsoft/da-forge/blob/main/LICENSE){target=\"_blank\"}","metrics":{"detailViews":0,"githubClicks":0},"dates":{"published":null,"modified":"2026-09-12T19:07:59.000Z"}}