Pack Informatique
Modèle de pack IT : assistant pour les tickets informatiques, sur des données fictives avec un connecteur itsm simulé.
Référence
| Champ | Valeur |
|---|---|
| Nom | it |
| Version | 1.0.0 |
| Licence | MIT |
| Type | Gabarit |
format | pack |
domain | it |
| Catégorie | it |
namespace | enterprise-ai-packs |
publisher | Enterprise AI reference packs |
owner | enterprise-ai-packs |
compatibility.platform | >=1.0.0 <2.0.0 |
compatibility.sdk | >=1.0.0 <2.0.0 |
compatibility.runtimes | navin |
dependencies | Aucun |
| Source | packs/templates/it/plugin.yaml |
| Documentation | packs/templates/it/docs/en/README.md, packs/templates/it/docs/fr/README.md |
Capacités
| Type | Nom |
|---|---|
tool | it-search |
tool | it-update-status |
connector | it-itsm |
policy | it |
Permissions demandées
L'administrateur en accorde une partie à l'installation ; seuls les scopes accordés s'appliquent.
| Scope | Sensible | Classification | Raison |
|---|---|---|---|
it.tickets.read | Non | internal | Lire les fiches de ticket informatique pour répondre aux questions. |
it.tickets.write | Oui | internal | Modifier le statut d'un ticket informatique après une approbation humaine. |
Protection des données
| Champ | Valeur |
|---|---|
classification_max | internal |
pii | false |
residency | eu-west-1 |
retention_days | 30 |
dlp | mask |
fictitious_data | true |
piiDetectionRequired | true |
maskingPolicy | mask |
externalExportDefault | deny |
Approbations
Requises pour : install, upgrade, sensitivePermissions, production, externalExport, resume.
| Étape | Quorum | Rôles |
|---|---|---|
install | 1 | tenant_admin, security_officer |
sensitive | 2 | tenant_admin, security_officer |
production | 2 | tenant_admin, security_officer |
Indicateurs de sécurité et de test
| Champ | Valeur |
|---|---|
security.signedArtifactRequired | true |
security.sandboxRequired | true |
security.dynamicAuthorization | true |
security.auditRequired | true |
testFlags.sdkConformance | true |
testFlags.authorization | true |
testFlags.security | true |
Configuration
Propriétés de spec.configSchema, renseignées par l'administrateur à l'installation :
| Nom | Type | Contraintes |
|---|---|---|
model_id | string | {"minLength": 3} |
mcp_servers | object | {"additionalProperties": {"additionalProperties": false, "properties": {"url": {"pattern": "^https?://", "type": "string"}}, "required": ["url"], "type": "object"}} |
Composants
| Type | Nom | Version | Description | Détails | Chemin |
|---|---|---|---|---|---|
| Agent | it-assistant | 1.0.0 | Répond aux questions sur les fiches de ticket informatique et prépare les changements de statut soumis à une approbation humaine. | risk_level: limited, autonomy.level: supervised, tools tool:it-search, tool:it-update-status | packs/templates/it/agents/it-assistant.yaml |
| Sous-agent | it-reviewer | 1.0.0 | Vérifie un changement de statut proposé pour un ticket informatique au regard des règles, avant l'approbation humaine. | risk_level: minimal, autonomy.level: assisted, tools tool:it-search | packs/templates/it/subagents/it-reviewer.yaml |
| Prompt | it-summary | - | Synthèse d'une fiche de ticket informatique pour un utilisateur métier. | variables record_id, audience, language | packs/templates/it/prompts/it-summary.yaml |
| Serveur MCP | it-mcp | - | Serveur MCP du pack IT (SDK MCP Python officiel, licence MIT). | transport: streamable_http, tools it_search, it_update_status | packs/templates/it/mcp/servers/it-mcp.yaml |
| Outil MCP | it-search | 1.0.0 | Rechercher des fiches fictives de ticket informatique via le serveur MCP du pack. | action: read, scopes it.tickets.read, risk_level: limited, requires_approval: false | packs/templates/it/mcp/tools/it-search.yaml |
| Outil MCP | it-update-status | 1.0.0 | Modifier le statut d'une fiche fictive de ticket informatique, de façon idempotente, après une approbation humaine. | action: write, scopes it.tickets.write, risk_level: high, requires_approval: true | packs/templates/it/mcp/tools/it-update-status.yaml |
| Connecteur | it-itsm | 1.0.0 | Connecteur itsm du pack IT. Simulé sur des données fictives tant que le tenant ne l'a pas configuré. | system: itsm, auth.type: api_key, scopes it.tickets.read, it.tickets.write | packs/templates/it/connectors/it-itsm.yaml |
| Workflow | it-status-change | - | Changement de statut d'un ticket informatique, avec une revue et une approbation à quatre yeux. | steps search, review, approval, apply, on_failure: stop | packs/templates/it/workflows/it-status-change.yaml |
| Base de connaissances | it-knowledge | - | Modèle de base de connaissances du pack IT (documents fictifs). | classification: internal | packs/templates/it/rag/config.yaml |
| Skill | it-guidelines | 1.0.0 | Comment l'assistant IT traite les fiches de ticket informatique. | scopes it.tickets.read, data_classification_max: internal | packs/templates/it/skills/it-guidelines/SKILL.md |
Évaluations et tests
| Nom | Type | Chemin | Seuil |
|---|---|---|---|
it-answers | promptfoo | evaluations/promptfoo.yaml | 1.0 |
it-retrieval | ragas | evaluations/ragas.jsonl | 0.8 |
| Type | Chemin |
|---|---|
unit | tests/unit |
integration | tests/integration |
authz | tests/authz |
security | tests/security |
opa | policies/opa |
Fichiers
| Type | Chemin |
|---|---|
| Règles | packs/templates/it/rules/it-rules.md |
| Politiques | packs/templates/it/policies/opa/it.rego, packs/templates/it/policies/opa/it_test.rego, packs/templates/it/policies/openfga/model.fga, packs/templates/it/policies/openfga/tests.fga.yaml |
| Observabilité | packs/templates/it/observability/alerts/it.yaml |
| Documents de la base de connaissances | packs/templates/it/rag/documents/guide.md |
L'installer
Validez, construisez, signez et publiez le pack, puis installez-le depuis la Marketplace : le contrôle préalable vérifie les capacités et la configuration avant l'installation.
enterprise-ai plugin validate packs/templates/it
enterprise-ai plugin build packs/templates/it --out /tmp/it-dist
COSIGN_PASSWORD=... enterprise-ai plugin sign packs/templates/it --out /tmp/it-dist --key cosign.key --signer <publisher>
enterprise-ai plugin publish packs/templates/it --out /tmp/it-dist --key cosign.key \
--oci <registry>/packs/it:1.0.0
cosign.key : clé de signature de votre organisation. <publisher> : nom de l'éditeur enregistré dans la Marketplace. <registry> : registre OCI de la Marketplace. Appelez ensuite POST /v1/marketplace/preflight puis POST /v1/marketplace/installations, voir le guide de la Marketplace.