Pack Finance
Pack de référence Finance : factures, soldes du grand livre, paiements idempotents et rapprochement, sur des données fictives avec un ERP simulé.
Référence
| Champ | Valeur |
|---|---|
| Nom | finance |
| Version | 1.0.0 |
| Licence | MIT |
| Type | Pack de référence |
format | pack |
domain | finance |
| Catégorie | finance |
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/finance/plugin.yaml |
| Documentation | packs/finance/docs/en/README.md, packs/finance/docs/fr/README.md |
Capacités
| Type | Nom |
|---|---|
tool | finance-invoice-lookup |
tool | finance-ledger-balance |
tool | finance-payment-initiate |
tool | finance-reconcile |
connector | finance-erp |
policy | finance |
Permissions demandées
L'administrateur en accorde une partie à l'installation ; seuls les scopes accordés s'appliquent.
| Scope | Sensible | Classification | Raison |
|---|---|---|---|
finance.invoices.read | Non | confidential | Lire les factures fournisseurs et leur statut. |
finance.ledger.read | Non | confidential | Lire les soldes des comptes du grand livre. |
finance.payments.write | Oui | restricted | Initier le paiement d'une facture approuvée, une seule fois. |
finance.reconciliation.read | Non | confidential | Rapprocher les lignes du relevé bancaire avec les paiements et les factures. |
Protection des données
| Champ | Valeur |
|---|---|
classification_max | restricted |
pii | false |
residency | eu-west-1 |
retention_days | 90 |
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 | finance-assistant | 1.0.0 | Répond sur les factures et les soldes du grand livre, initie une seule fois les paiements approuvés, exécute le rapprochement. | risk_level: limited, autonomy.level: supervised, tools tool:finance-invoice-lookup, tool:finance-ledger-balance, tool:finance-payment-initiate, tool:finance-reconcile | packs/finance/agents/finance-assistant.yaml |
| Sous-agent | finance-controller | 1.0.0 | Contrôle un paiement proposé au regard de la facture et du rapprochement, avant l'approbation humaine. | risk_level: minimal, autonomy.level: assisted, tools tool:finance-invoice-lookup, tool:finance-reconcile | packs/finance/subagents/finance-controller.yaml |
| Prompt | finance-close-report | - | Rapport de clôture mensuelle établi à partir du résultat du rapprochement. | variables period, matched, unmatched, language | packs/finance/prompts/finance-close-report.yaml |
| Prompt | finance-invoice-answer | - | Réponse de l'assistant Finance sur une facture. | variables invoice_id, supplier, status, open_amount, currency, language | packs/finance/prompts/finance-invoice-answer.yaml |
| Serveur MCP | finance-mcp | - | Serveur MCP du pack Finance (SDK MCP Python officiel, licence MIT). | transport: streamable_http, tools finance_invoice_lookup, finance_ledger_balance, finance_payment_initiate, finance_reconcile | packs/finance/mcp/servers/finance-mcp.yaml |
| Outil MCP | finance-invoice-lookup | 1.0.0 | Facture fournisseur fictive, avec son statut et le montant restant dû, sans coordonnées bancaires. | action: read, scopes finance.invoices.read, risk_level: limited, requires_approval: false | packs/finance/mcp/tools/finance-invoice-lookup.yaml |
| Outil MCP | finance-ledger-balance | 1.0.0 | Solde d'un compte fictif du grand livre. | action: read, scopes finance.ledger.read, risk_level: limited, requires_approval: false | packs/finance/mcp/tools/finance-ledger-balance.yaml |
| Outil MCP | finance-payment-initiate | 1.0.0 | Payer une seule fois une facture fictive approuvée, de façon idempotente par clé, après une approbation humaine. | action: payment, scopes finance.payments.write, risk_level: high, requires_approval: true | packs/finance/mcp/tools/finance-payment-initiate.yaml |
| Outil MCP | finance-reconcile | 1.0.0 | Rapprocher le relevé bancaire fictif avec les paiements et les factures. | action: read, scopes finance.reconciliation.read, risk_level: limited, requires_approval: false | packs/finance/mcp/tools/finance-reconcile.yaml |
| Connecteur | finance-erp | 1.0.0 | Connecteur ERP du pack Finance. Simulé sur des factures fictives tant que le tenant ne l'a pas configuré. | system: erp, auth.type: service_account, scopes finance.invoices.read, finance.ledger.read, finance.payments.write, finance.reconciliation.read | packs/finance/connectors/finance-erp.yaml |
| Workflow | finance-invoice-payment | - | Paiement d'une facture approuvée, avec la revue d'un contrôleur et une approbation à quatre yeux. | steps invoice, review, approval, pay, reconcile, on_failure: stop | packs/finance/workflows/finance-invoice-payment.yaml |
| Base de connaissances | finance-knowledge | - | Base de connaissances du pack Finance (procédure fictive de comptabilité fournisseurs). | classification: internal | packs/finance/rag/config.yaml |
| Skill | finance-month-end-close | 1.0.0 | Liste de contrôle de la clôture mensuelle : soldes, factures en attente et rapprochement. | scopes finance.ledger.read, finance.reconciliation.read, data_classification_max: confidential | packs/finance/skills/finance-month-end-close/SKILL.md |
| Skill | finance-payment-controls | 1.0.0 | Contrôles appliqués avant et pendant l'initiation d'un paiement fournisseur. | scopes finance.payments.write, data_classification_max: restricted | packs/finance/skills/finance-payment-controls/SKILL.md |
Évaluations et tests
| Nom | Type | Chemin | Seuil |
|---|---|---|---|
finance-answers | promptfoo | evaluations/promptfoo.yaml | 1.0 |
finance-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/finance/rules/finance-rules.md |
| Politiques | packs/finance/policies/opa/finance.rego, packs/finance/policies/opa/finance_test.rego, packs/finance/policies/openfga/model.fga, packs/finance/policies/openfga/tests.fga.yaml |
| Observabilité | packs/finance/observability/alerts/finance.yaml |
| Documents de la base de connaissances | packs/finance/rag/documents/payables-procedure.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/finance
enterprise-ai plugin build packs/finance --out /tmp/finance-dist
COSIGN_PASSWORD=... enterprise-ai plugin sign packs/finance --out /tmp/finance-dist --key cosign.key --signer <publisher>
enterprise-ai plugin publish packs/finance --out /tmp/finance-dist --key cosign.key \
--oci <registry>/packs/finance: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.