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