Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Conseil
Recommandé : Commencez avec les outils de développement Work IQ pour les scénarios de plug-in et d’agent déclaratif pro-code pris en charge. Voir le guide de démarrage rapide de WIQD. Les instructions basées sur la boîte à outils restent disponibles pour les projets existants et les flux de travail qui les nécessitent. Vérifiez la prise en charge de la capacité et de l’expérience cible avant de choisir un outil : WIQD ne cible pas les agents de moteur personnalisés.
Ce guide fournit des exemples complets de création d’agents TypeSpec pour Microsoft 365 Copilot, des agents de base simples aux implémentations complexes avec plusieurs fonctionnalités et méthodes d’authentification.
Agent de base sans fonctionnalités
Cas d’utilisation : agent simple qui fournit des informations de base et des messages d’accueil sans aucune intégration externe ou capacité particulière.
Fonction : cet agent peut répondre à des questions simples, fournir des informations générales et avoir des conversations de base. Il n’a pas besoin d’accéder à des API externes, de rechercher sur le web ou d’accéder à des données Microsoft 365.
import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";
using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;
@agent("Basic Helper Agent", "A simple agent that provides basic information and assistance")
@instructions("""
You are a helpful assistant that provides basic information and support.
Be friendly, professional, and helpful in all interactions. Provide clear,
concise answers to user questions. If you don't know something, be honest
about your limitations and suggest alternative ways to find the information.
""")
namespace BasicHelperAgent {
// No capabilities defined - agent relies only on built-in conversational abilities
}
Agent aux multiples fonctionnalités
Cas d’utilisation : un assistant de travail du savoir qui peut rechercher des informations sur le web, accéder au contenu SharePoint d’une organisation et trouver des informations sur les collègues de l’organisation.
Fonction : cet agent aide les travailleurs du savoir en combinant la recherche d’informations externes sur le web, l’accès aux fichiers pour la récupération de documents et la recherche de collègues et leurs coordonnées. Ce modèle s’adapte aux scénarios de recherche et de collaboration.
import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";
using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;
@agent("Knowledge Worker Assistant", "An intelligent assistant that helps with research, file management, and finding colleagues")
@instructions("""
You are a knowledgeable research assistant specialized in helping knowledge workers
find information efficiently. You can search the web for external research, access
SharePoint documents for organizational content, and help locate colleagues within
the organization. Always provide comprehensive research results, cite your sources,
and suggest additional resources when relevant. When searching for people, respect
privacy and only share publicly available organizational information.
""")
namespace KnowledgeWorkerAgent {
// Web search capability for external research
op webSearch is AgentCapabilities.WebSearch<Sites = [
{
url: "https://learn.microsoft.com";
},
{
url: "https://www.microsoft.com";
}
]>;
// OneDrive and SharePoint access for document retrieval
op oneDriveAndSharePoint is AgentCapabilities.OneDriveAndSharePoint<
ItemsByUrl = [
{ url: "https://contoso.sharepoint.com/sites/IT" }
]
>;
// People search for finding colleagues
op people is AgentCapabilities.People;
}
Agent simple avec action d’API anonyme
Cas d’utilisation : un agent de gestion des installations qui aide les utilisateurs à signaler et à suivre les problèmes de maintenance à l’aide d’une API de réparation publique.
Fonction : Cet agent permet aux utilisateurs de signaler les problèmes d’installation (équipement cassé, problèmes d’éclairage, etc.) et de case activée le status des demandes de réparation existantes. L’API de réparation est accessible publiquement et ne nécessite pas d’authentification, ce qui permet à quiconque de signaler facilement des problèmes.
import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";
import "./actions.tsp";
using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;
using TypeSpec.M365.Copilot.Actions;
@agent("Facilities Repair Agent", "Report and track facility maintenance issues and repair requests")
@instructions("""
You are a facilities management assistant that helps employees report and track
maintenance issues. You can help users submit new repair requests by gathering
all necessary details (description, location, category, priority) and submit
them to the facilities team. You can also check the status of existing repair
tickets and provide updates on progress. Always be helpful in categorizing
issues correctly and setting appropriate priority levels based on safety and
business impact.
""")
namespace FacilitiesRepairAgent {
op reportIssue is RepairsAPI.reportIssue;
op getRepairStatus is RepairsAPI.getRepairStatus;
op getOpenRepairs is RepairsAPI.getOpenRepairs;
}
Agent avancé avec authentification par clé API
Cas d’utilisation : un agent de gestion des réparations qui aide les équipes à suivre et à gérer les tâches de maintenance des installations à l’aide d’une API accessible au public avec authentification par clé API.
Fonction : cet agent offre des fonctionnalités complètes de gestion des réparations aux équipes de maintenance. Il peut répertorier, créer, mettre à jour et supprimer des tâches de réparation, filtrer les réparations par personne affectée ou description et fournir des réponses riches basées sur des cartes avec des images. L’authentification par clé API garantit un accès contrôlé au système de gestion des réparations tout en démontrant des modèles d’intégration d’API réels.
import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";
import "./actions.tsp";
using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;
using TypeSpec.M365.Copilot.Actions;
@agent("Repairs Hub Agent", "Smart repair management agent for tracking and coordinating facility maintenance tasks")
@instructions("""
You are a specialized repairs management assistant that helps teams efficiently track,
organize, and coordinate facility maintenance tasks. You excel at managing repair
workflows including creating detailed repair tickets, assigning tasks to team members,
tracking progress, and providing status updates. You can filter repairs by various
criteria such as assignee, keywords in descriptions, or completion status. Always
provide clear, organized information using tables and cards when displaying repair
data. When creating repairs, gather all necessary details and confirm the information
before submission. Help prioritize urgent repairs and ensure proper task assignment
for optimal team productivity.
""")
@conversationStarter(#{
title: "List repairs",
text: "List all repairs"
})
@conversationStarter(#{
title: "List Karin's repairs",
text: "List all repairs assigned to Karin"
})
@conversationStarter(#{
title: "Find oil repairs",
text: "List all repairs that are about oil"
})
@conversationStarter(#{
title: "Create repair",
text: "Create a new repair and assign it to me"
})
namespace RepairsAgent {
// Repair management operations
op listRepairs is RepairsHub.listRepairs;
op createRepair is RepairsHub.createRepair;
op updateRepair is RepairsHub.updateRepair;
op deleteRepair is RepairsHub.deleteRepair;
}
Agent complexe avec intégration OAuth2 et API GitHub
Cas d’utilisation : Un agent de gestion de projet qui aide les équipes de développement à gérer leurs référentiels GitHub, à suivre les problèmes, à gérer les demandes de tirage et à coordonner les activités de projet à l’aide de l’API complète de GitHub.
Fonction : cet agent sert d’assistant de gestion de projet qui s’intègre à GitHub pour aider les équipes de développement à rationaliser leurs flux de travail. Il peut créer et gérer des problèmes, examiner et fusionner des demandes de tirage, suivre les jalons du projet et fournir des informations sur l’activité des dépôts. L’authentification OAuth2 garantit un accès sécurisé aux référentiels GitHub avec les autorisations appropriées, permettant aux équipes de gérer efficacement leurs projets grâce à des interactions en langage naturel.
import "@typespec/http";
import "@typespec/openapi3";
import "@microsoft/typespec-m365-copilot";
import "./actions.tsp";
using TypeSpec.Http;
using TypeSpec.M365.Copilot.Agents;
using TypeSpec.M365.Copilot.Actions;
@agent("GitHub Project Manager", "Smart project management agent with GitHub integration for issue tracking, pull request management, and project coordination")
@instructions("""
You are an intelligent project management assistant specialized in GitHub workflows
and development team coordination. You excel at managing GitHub repositories including
creating and tracking issues, reviewing pull requests, coordinating project milestones,
and providing insights about development activity. You can help prioritize work,
track progress, manage code reviews, and facilitate team collaboration through GitHub's
project management features. Always consider development best practices, help maintain
code quality through proper review processes, and provide actionable insights to
improve team productivity and project delivery.
""")
namespace GitHubProjectManager {
// GitHub API operations for project management
op createIssue is GitHubAPI.createIssue;
op getIssues is GitHubAPI.getIssues;
op updateIssue is GitHubAPI.updateIssue;
op getPullRequests is GitHubAPI.getPullRequests;
op createPullRequest is GitHubAPI.createPullRequest;
op mergePullRequest is GitHubAPI.mergePullRequest;
op getProjectInsights is GitHubAPI.getProjectInsights;
}
Résumé
Les exemples suivants illustrent la progression d’agents TypeSpec simples à complexes :
- Agent de base : aucune capacité, IA conversationnelle pure
- Agent multi-capacité : combine la recherche web, l’accès aux fichiers et la recherche de personnes
- Intégration API simple : accès anonyme aux services externes
- Intégration d’API authentifiée : sécuriser l’accès avec des clés API
- Intégration complexe de GitHub : OAuth2 avancé avec un accès complet à l’API GitHub pour la gestion de projet
Chaque exemple s’appuie sur les précédents, montrant comment ajouter des fonctionnalités, une authentification et des actions personnalisées pour créer des agents plus complexes pour des scénarios réels.