Servicebeschrijving¶
Deze pagina beschrijft wat de Agentic Developer Portal aanbiedt, wat elke functie nodig heeft voordat er data verschijnt, en waar de service ophoudt. De namen, standaardwaarden en schema's zijn die van het referentieontwerp. Jouw platform kan afwijken. Vraag je platformteam welke functies in jouw omgeving aanstaan.
De service in het kort¶
| Aspect | Beschrijving |
|---|---|
| Levering | Eén portaal per klantomgeving (meestal non-productie en productie), uitgerold in de eigen Azure-subscriptions van de klant |
| Codebase | Eén gedeelde codebase en één container image voor alle klanten. Functies worden via configuratie ingeschakeld, niet via klantspecifieke code. |
| Updates | Nieuwe versies worden voor alle klanten uitgebracht en omgeving voor omgeving uitgerold (Uitrol en omgevingen) |
| Data | Alle data die het portaal verzamelt, verwerkt en opslaat blijft in de Azure-subscriptions van de klant (Architectuur) |
| Gebruikers | Mensen uit de Entra ID-tenant van de klant die tot de toegestane groepen behoren (Authenticatie en toegang) |
| Kosten | De Azure-resources van het portaal draaien op de Azure-rekening van de klant. Functies zoals cost insights en AI-agents voegen resources en dus kosten toe. |
Functies¶
| Functie | Wat de gebruiker ziet | Vereist | Pagina |
|---|---|---|---|
| Workloads en domeinen | Explorer-pagina's voor workloads en domeinen, entiteitspagina's met eigenaar, domein, afhankelijkheden en subscriptions | Subscriptions getagd met een workload en een eigenaar, en gebruikers en groepen uit Entra ID | Catalog en entiteitenmodel |
| Organisatieweergave | Een pagina voor organisaties (klanten) en hun domeinen | Feature flag features.organisation |
Catalog en entiteitenmodel |
| Cost insights | Maandelijkse kosten per subscription, workload, team en domein | Cost insights-resources en kostenexports (Cost insights-setup) | Insights |
| Network insights | Geblokkeerde firewallverzoeken, Application Gateway-toegang en WAF-logs op de workloadpagina | Azure Firewall- en Application Gateway-diagnostics in Log Analytics | Insights |
| Security insights | Secure score en aanbevelingen | Microsoft Defender for Cloud op de subscriptions | Insights |
| Compliance insights | Compliancematrix per regulatory standaard | Regulatory compliance-initiatives toegewezen met Azure Policy | Insights |
| AI-agents | Een chatpagina met de ingeschakelde agents | Een Azure AI Foundry-account en agentconfiguratie (AI-setup) | AI-agents |
| MCP-server en inspector | Een server voor editors en agents, en een pagina om de tools uit te proberen | Altijd aanwezig. Toegang met een token of via aanmelden | MCP-server |
| Module registry | Lijst, detail en download van Terraform-modules | Feature flag features.moduleRegistry en een registry-API |
Module registry |
| Documentatie (TechDocs) | Documentatiepagina's van services waarvan de repository een mkdocs.yml bevat |
Zie de opmerking hieronder | |
| Software templates (Create) | Templates voor standaardwijzigingen | Feature flag features.scaffolder, alleen in de omgeving van de leverancier |
Configuratie |
Functies verschillen per omgeving
De leveringsdocumenten van de bron stellen dat elke klant de volledige functieset van de uitgerolde versie krijgt. De code schakelt echter meerdere functies in via configuratie (feature flags, een gekoppelde kostendatabase, agentinstellingen). Lees de tabel als "wat bestaat" en vraag je platformteam "wat staat er aan in mijn omgeving". Beschrijf aan je gebruikers alleen wat daadwerkelijk is uitgerold.
TechDocs
De TechDocs-backend maakt deel uit van het portaal, en het leveringsmateriaal noemt TechDocs onder de self-servicemogelijkheden. Een feature flag in de code zet de documentatie-ingang alleen aan voor de eigen omgeving van de leverancier en voor lokale ontwikkeling. Controleer bij je platformteam of TechDocs voor jou is ingeschakeld.
Data die het portaal verwerkt¶
| Data | Bron | Opgeslagen in |
|---|---|---|
| Catalog-entiteiten, relaties, agentgesprekken, security- en complianceresultaten, netwerkinventaris | Azure Resource Graph, Azure DevOps, Microsoft Graph (Entra ID), het portaal zelf | De PostgreSQL-database van het portaal in de klantomgeving |
| Kostendata | Azure Cost Management-exports, ingelezen door Azure Data Factory | Storage accounts en een Azure SQL-database in de klantomgeving |
| Logregels van firewall en WAF | Log Analytics workspaces van de klant | Op verzoek bevraagd, niet permanent gekopieerd |
| Secrets en sleutels van het portaal | Aangemaakt door Terraform en de deploymentpipeline | De Key Vault van de omgeving |
Het model dat agentprompts beantwoordt, wordt geleverd door het eigen Azure AI Foundry-account van de klant. De gespreksgeschiedenis wordt bewaard in de PostgreSQL-database van het portaal, niet in Foundry.
Wat de service niet doet¶
- Geen wijzigingen aan Azure-resources. Het portaal leest. Agents en de MCP-tools bereiden pull requests voor in repositories. Ze mergen ze niet.
- Geen klantspecifieke code. Een aanvraag die een functie voor één klant vereist, wordt als apart werk behandeld en beslist door de solution lead van de leverancier. Het wijzigt de gedeelde codebase niet voor één klant.
- Geen data buiten de klantomgeving. De leverancier kopieert geen klantdata naar de eigen omgeving.
- Geen dekking buiten de leesbare scope. Het portaal toont alleen subscriptions die de managed identity kan lezen. Een subscription buiten de verleende management group is niet zichtbaar.
- Geen contractvoorwaarden in deze pagina's. Supporturen, reactietijden en service levels volgen uit je overeenkomst. Het leveringsmateriaal van de bron merkt op dat de formulering van de operationele garantie en van de offboarding nog moet worden bevestigd. Deze pagina's noemen geen van beide.
Verantwoordelijkheden¶
| Platformteam | Workload team | |
|---|---|---|
| Het portaal uitrollen, bijwerken en monitoren | Ja | |
| Het portaal leestoegang geven in Azure, Entra ID en repositories | Ja (beheerders van de klant keuren goed) | |
| De databronnen gezond houden (Defender for Cloud, policy-toewijzingen, diagnostics, kostenexports) | Ja, voor onderdelen van het platform | Voor resources van de workload |
| Subscriptions taggen met workload en eigenaar | Ja, voor spokes die het platform uitrolt | Voor tags die het platform niet zet |
| Eigenaar zijn van workloads in de catalog, handelen op aanbevelingen en policy-bevindingen | Ja | |
| Pull requests beoordelen die agents hebben voorbereid | Ja, voor platformconfiguratie | Ja, voor repositories die het team beheert |
De algemene verdeling staat in Verantwoordelijkheden.