Pack Support
Modèle de pack Support : assistant pour les dossiers de support, sur des données fictives avec un connecteur helpdesk simulé.
Référence
| Champ | Valeur |
|---|---|
| Nom | support |
| Version | 1.0.0 |
| Licence | MIT |
| Type | Gabarit |
format | pack |
domain | support |
| Catégorie | support |
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/support/plugin.yaml |
| Documentation | packs/templates/support/docs/en/README.md, packs/templates/support/docs/fr/README.md |
Capacités
| Type | Nom |
|---|---|
tool | support-search |
tool | support-update-status |
connector | support-helpdesk |
policy | support |
Permissions demandées
L'administrateur en accorde une partie à l'installation ; seuls les scopes accordés s'appliquent.
| Scope | Sensible | Classification | Raison |
|---|---|---|---|
support.cases.read | Non | confidential | Lire les fiches de dossier de support pour répondre aux questions. |
support.cases.write | Oui | confidential | Modifier le statut d'un dossier de support après une approbation humaine. |
Protection des données
| Champ | Valeur |
|---|---|
classification_max | confidential |
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 | support-assistant | 1.0.0 | Répond aux questions sur les fiches de dossier de support et prépare les changements de statut soumis à une approbation humaine. | risk_level: limited, autonomy.level: supervised, tools tool:support-search, tool:support-update-status | packs/templates/support/agents/support-assistant.yaml |
| Sous-agent | support-reviewer | 1.0.0 | Vérifie un changement de statut proposé pour un dossier de support au regard des règles, avant l'approbation humaine. | risk_level: minimal, autonomy.level: assisted, tools tool:support-search | packs/templates/support/subagents/support-reviewer.yaml |
| Prompt | support-summary | - | Synthèse d'une fiche de dossier de support pour un utilisateur métier. | variables record_id, audience, language | packs/templates/support/prompts/support-summary.yaml |
| Serveur MCP | support-mcp | - | Serveur MCP du pack Support (SDK MCP Python officiel, licence MIT). | transport: streamable_http, tools support_search, support_update_status | packs/templates/support/mcp/servers/support-mcp.yaml |
| Outil MCP | support-search | 1.0.0 | Rechercher des fiches fictives de dossier de support via le serveur MCP du pack. | action: read, scopes support.cases.read, risk_level: limited, requires_approval: false | packs/templates/support/mcp/tools/support-search.yaml |
| Outil MCP | support-update-status | 1.0.0 | Modifier le statut d'une fiche fictive de dossier de support, de façon idempotente, après une approbation humaine. | action: write, scopes support.cases.write, risk_level: high, requires_approval: true | packs/templates/support/mcp/tools/support-update-status.yaml |
| Connecteur | support-helpdesk | 1.0.0 | Connecteur helpdesk du pack Support. Simulé sur des données fictives tant que le tenant ne l'a pas configuré. | system: helpdesk, auth.type: api_key, scopes support.cases.read, support.cases.write | packs/templates/support/connectors/support-helpdesk.yaml |
| Workflow | support-status-change | - | Changement de statut d'un dossier de support, avec une revue et une approbation à quatre yeux. | steps search, review, approval, apply, on_failure: stop | packs/templates/support/workflows/support-status-change.yaml |
| Base de connaissances | support-knowledge | - | Modèle de base de connaissances du pack Support (documents fictifs). | classification: internal | packs/templates/support/rag/config.yaml |
| Skill | support-guidelines | 1.0.0 | Comment l'assistant Support traite les fiches de dossier de support. | scopes support.cases.read, data_classification_max: confidential | packs/templates/support/skills/support-guidelines/SKILL.md |
Évaluations et tests
| Nom | Type | Chemin | Seuil |
|---|---|---|---|
support-answers | promptfoo | evaluations/promptfoo.yaml | 1.0 |
support-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/support/rules/support-rules.md |
| Politiques | packs/templates/support/policies/opa/support.rego, packs/templates/support/policies/opa/support_test.rego, packs/templates/support/policies/openfga/model.fga, packs/templates/support/policies/openfga/tests.fga.yaml |
| Observabilité | packs/templates/support/observability/alerts/support.yaml |
| Documents de la base de connaissances | packs/templates/support/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/support
enterprise-ai plugin build packs/templates/support --out /tmp/support-dist
COSIGN_PASSWORD=... enterprise-ai plugin sign packs/templates/support --out /tmp/support-dist --key cosign.key --signer <publisher>
enterprise-ai plugin publish packs/templates/support --out /tmp/support-dist --key cosign.key \
--oci <registry>/packs/support: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.