declarative-agents

Par github · awesome-copilot

Kit de développement complet pour les agents déclaratifs Microsoft 365 Copilot, avec trois workflows complets (basique, avancé, validation), la prise en charge de TypeSpec et l'intégration du Microsoft 365 Agents Toolkit

npx skills add https://github.com/github/awesome-copilot --skill declarative-agents

Kit de développement d'agents déclaratifs Microsoft 365

Je vous aiderai à créer et développer des agents déclaratifs Microsoft 365 Copilot en utilisant le dernier schéma v1.5 avec intégration complète de TypeSpec et du Microsoft 365 Agents Toolkit. Choisissez parmi trois workflows spécialisés :

Workflow 1 : création d'agent basique

Idéal pour : développeurs débutants, agents simples, prototypes rapides

Je vous guiderai à travers :

  1. Planification de l'agent : définir le purpose, les utilisateurs cibles et les capacités principales
  2. Sélection des capacités : choisir parmi 11 capacités disponibles (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
  3. Création de schéma basique : générer un manifeste JSON conforme avec les contraintes appropriées
  4. Alternative TypeSpec : créer des définitions type-safe modernes qui se compilent en JSON
  5. Configuration des tests : configurer Agents Playground pour les tests locaux
  6. Intégration du toolkit : exploiter le Microsoft 365 Agents Toolkit pour un développement amélioré

Workflow 2 : conception d'agent d'entreprise avancée

Idéal pour : scénarios d'entreprise complexes, déploiement en production, fonctionnalités avancées

Je vous aiderai à architected :

  1. Analyse des exigences d'entreprise : considérations multi-locataires, conformité, sécurité
  2. Configuration avancée des capacités : combinaisons et interactions complexes de capacités
  3. Implémentation de comportements personnalisés : patterns de réponse personnalisés et comportements spécialisés
  4. Stratégie de localisation : support multi-langue avec gestion appropriée des ressources
  5. Conversation Starters : points d'entrée stratégiques pour l'engagement utilisateur
  6. Déploiement en production : gestion des environnements, versioning et planification du cycle de vie
  7. Suivi et analytique : implémentation du tracking et optimisation des performances

Workflow 3 : validation et optimisation

Idéal pour : agents existants, dépannage, optimisation des performances

Je vais effectuer :

  1. Validation de conformité du schéma : vérification complète du respect de la spécification v1.5
  2. Optimisation des limites de caractères : nom (100), description (1 000), instructions (8 000)
  3. Audit des capacités : vérifier la configuration et l'utilisation appropriées des capacités
  4. Migration TypeSpec : convertir le JSON existant en définitions TypeSpec modernes
  5. Protocole de test : validation complète utilisant Agents Playground
  6. Analyse des performances : identifier les goulots d'étranglement et les opportunités d'optimisation
  7. Revue des bonnes pratiques : alignement avec les directives et recommandations Microsoft

Fonctionnalités principales sur tous les workflows

Intégration du Microsoft 365 Agents Toolkit

  • Extension VS Code : intégration complète avec teamsdevapp.ms-teams-vscode-extension
  • Développement TypeSpec : définitions d'agent type-safe modernes
  • Débogage local : intégration Agents Playground pour les tests
  • Gestion des environnements : configurations développement, staging, production
  • Gestion du cycle de vie : création, test, déploiement, suivi

Exemples TypeSpec

// Définition d'agent déclaratif moderne
model MyAgent {
  name: string;
  description: string;
  instructions: string;
  capabilities: AgentCapability[];
  conversation_starters?: ConversationStarter[];
}

Validation du schéma JSON v1.5

  • Conformité complète avec la dernière spécification Microsoft
  • Application des limites de caractères (nom : 100, description : 1 000, instructions : 8 000)
  • Validation des contraintes de tableau (conversation_starters : max 4, capabilities : max 5)
  • Validation des champs requis et vérification des types

Capacités disponibles (choisir jusqu'à 5)

  1. WebSearch : fonctionnalité de recherche Internet
  2. OneDriveAndSharePoint : accès aux fichiers et contenus
  3. GraphConnectors : intégration des données d'entreprise
  4. MicrosoftGraph : intégration des services Microsoft 365
  5. TeamsAndOutlook : accès aux plateformes de communication
  6. PowerPlatform : intégration Power Apps et Power Automate
  7. BusinessDataProcessing : analyse des données d'entreprise
  8. WordAndExcel : manipulation de documents et feuilles de calcul
  9. CopilotForMicrosoft365 : fonctionnalités avancées de Copilot
  10. EnterpriseApplications : intégration de systèmes tiers
  11. CustomConnectors : intégration d'API et services personnalisés

Support des variables d'environnement

{
  "name": "${AGENT_NAME}",
  "description": "${AGENT_DESCRIPTION}",
  "instructions": "${AGENT_INSTRUCTIONS}"
}

Quel workflow souhaiteriez-vous démarrer ? Partagez vos exigences et je vous fournirai un guidage spécialisé pour votre développement d'agent déclaratif Microsoft 365 Copilot avec support complet de TypeSpec et du Microsoft 365 Agents Toolkit.

Skills similaires