Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Le Competenze di Agent 365 offrono un percorso guidato per l'installazione di un agente esistente all'Agent 365 da un assistente di codifica supportato. Dichiari il risultato che desideri, ad esempio aggiungere osservabilità a questo agente, e la competenza identifica il progetto, raccoglie i valori richiesti, apporta le modifiche di integrazione e verifica il risultato.
Le competenze sono eseguite in tutti gli agenti di codifica, inclusi Claude Code, GitHub Copilot CLI e modalità agente VS Code.
Per installare le competenze e seguire il percorso di onboarding per il tuo agente, consulta Quickstart: Collega un agente esistente all'Agente 365.
Note
Le competenze sostituiscono il precedente flusso di lavoro di configurazione che utilizzava un instructions.md file.
Quando usare le Abilità
Collegare un agente esistente all'identità aziendale, all'osservabilità, agli strumenti governati e alle notifiche richiede diversi passaggi ordinati di configurazione. Questi passaggi includono l'installazione della CLI di Agent 365, la validazione dei prerequisiti di Azure, la registrazione di un blueprint, la configurazione delle risorse Entra, il cablaggio degli esportatori OpenTelemetry, la connessione dei server Model Context Protocol (MCP) e i test locali.
Le competenze eseguono quei passaggi nell'ordine richiesto per il percorso selezionato e convalidano il progetto risultante.
Come funziona un'abilità
Ogni abilità segue lo stesso flusso di lavoro:
- Dichiara il risultato che desideri.
- Lascia che la competenza identifichi lo stack di progetto e la configurazione esistente.
- Fornisci i valori richiesti, come la modalità di autenticazione.
- Rivedi il codice, i manifesti e le modifiche alla configurazione che effettua.
- Conferma che il progetto sia ancora in fase di sviluppo e che l'integrazione funzioni.
Le sette abilità
a365-setup è il punto d'ingresso. Dopo aver validato i prerequisiti, ti indirizza su uno di due percorsi, e segui solo quel percorso:
-
Agente standard.
a365-setupdelega amake-a365-agent. Usa questo percorso quando l'agente ha bisogno di registrazione e osservabilità ma non di account utente. -
Compagno di squadra IA.
a365-setupdelega amake-ai-teammate, per un agente che ha bisogno del proprio account utente. Questo percorso richiede il programma di anteprima Frontier.
| Skill | Purpose |
|---|---|
a365-setup |
Installa la CLI dell'Agent 365, valida i prerequisiti di Azure, rileva lo stack degli agenti, poi delega a make-a365-agent o make-ai-teammate. |
make-a365-agent |
Fornisce un agente standard che non ha bisogno di un proprio account utente. Registra il blueprint dell'identità dell'agente in Microsoft Entra, crea un'identità di agente da esso e configura i permessi Entra ID di cui l'agente ha bisogno, poi offre osservabilità e strumenti aggiuntivi. |
make-ai-teammate |
Trasforma un agente in un compagno IA con un proprio account utente. Registra il blueprint dell'identità dell'agente e crea un'identità dell'agente da esso, poi aggiunge il livello di hosting, l'instradamento dei messaggi e le notifiche. Deve a365-setup essere già stato corretto prima. |
instrument-observability |
Wires OpenTelemetry e l'esportatore di tracciamento Agent 365 per le coperture degli agenti raggiungono Microsoft Defender, Microsoft Purview e il interfaccia di amministrazione di Microsoft 365. Chiede il tipo di agente e la modalità di autenticazione; vedi Identità dell'agente. |
a365-code-validator |
Valida e diagnostica un'integrazione Agent 365 esistente, inclusi strumentazione, artefatti Microsoft Entra, messaggistica, accesso agli strumenti e configurazione correlata. Sola lettura per impostazione predefinita. Usa instrument-observability per aggiungere osservabilità da zero. |
add-workiq-tools |
Collega i server MCP di Work IQ, inclusi Mail, Calendar e Word, così l'agente può leggere e agire sui dati Microsoft 365. Richiede un modello di permessi delegati ed è saltato automaticamente quando la modalità di autenticazione è S2S. |
test-local |
Gestisce un agente IA del teammate localmente e apre Agents Playground per test interattivi, senza bisogno di un deployment cloud. Si applica al percorso dei compagni di squadra IA. |
Importante
make-ai-teammate dà al tuo agente un account utente proprio, inclusa una casella postale e presenza su Teams. Questa funzionalità è disponibile solo per gli inquilini che partecipano al programma di anteprima Frontier.
Di solito invochi un'abilità dichiarando il risultato invece di dare un nome. Ad esempio, aggiungendo osservabilità a questo agente si esegue instrument-observability. Se il tuo assistente di codifica espone la capacità interna a365-code-validator , chiedigli di validare questa integrazione con Agent 365; la capacità è anche descritta internamente come Validate & Diagnose. Disponibilità e invocazione dipendono dall'assistente e dal pacchetto Skills installato. Per la formulazione della richiesta utilizzata in ogni fase, vedi Quickstart: Collega un agente esistente all'Agente 365.
Stack supportati
Le competenze rilevano automaticamente lo stack di progetti, quindi non devi mappare manualmente il progetto. Questi sono gli stack che le Abilità rilevano. L'SDK funziona anche con altri framework.
| Lingua | Frameworks |
|---|---|
| .NET | Microsoft Agent Framework, Kernel semantico, Azure AI Foundry |
| Node.js | LangChain, OpenAI Agents SDK, Claude Agent SDK, Kernel semantico, Google ADK |
| Python | Microsoft Agent Framework, LangChain, OpenAI Agents SDK, Claude Agent SDK, Kernel semantico, Google ADK |
Sicurezza e ripetibilità
Le competenze sono progettate per applicare modifiche alla configurazione senza alterare il comportamento esistente del tuo progetto. Conferma questo comportamento con la checklist di validazione SDK dell'Agent 365.
- Additivo e idempotente. Le competenze non cancellano né ristrutturano il codice esistente, e rieseguire una competenza non duplica il lavoro completato.
- Consapevole dello stato. Le abilità rilevano ciò che è già collegato, quindi saltano invece di ripetere i passaggi completati.
- Guard-rail. Le competenze non modificano i file al di fuori del tuo progetto e verificano che la build sia comunque superata prima di completarla.
Usa le abilità quando:
- Hai già un agente e vuoi integrarlo senza scrivere l'integrazione a mano.
- Il tuo flusso di lavoro di sviluppo include già un assistente di programmazione.
- Vuoi un onboarding coerente e ripetibile tra i progetti.
Usa la configurazione manuale quando:
- Il tuo ambiente è non standard e ogni passaggio richiede un controllo individuale.
- La tua organizzazione limita i flussi di lavoro degli assistenti di programmazione.
- Stai facendo troubleshooting e vuoi eseguire ogni passaggio da solo.
Per il percorso manuale, usa i passaggi di configurazione in Quickstart: collega un agente esistente all'Agent 365 ed esegui i comandi equivalenti della CLI dell'Agent 365 per il tuo ambiente.