garde-fous d’agent UiP

Répertoriez les définitions des garde-fous, les garde-fous BYOM, les modèles LLM en tant que juge et le catalogue de garde-fous avec « uip agent guardrails ».

uip agent guardrails est un groupe de découverte en lecture seule pour les garde-fous qu'un projet d'agent peut référencer — validateurs intégrés et création de connexions de garde-fous personnalisés — plus les modèles disponibles pour le garde-fou LLM-as-judge et le métadonnées de catalogue créées (descriptions, cas d'utilisation, exemples) pour chaque validateur. Il n'attache pas de garde-fou à un projet; cela se fait en modifiant manuellement agent.json.

Synthèse

uip agent guardrails list [--byo]
uip agent guardrails llm-as-judge-models
uip agent guardrails catalog [--validator <id>]

Toutes les invocations respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

liste des garde-fous des agents uip

Répertoriez les définitions de garde-fous disponibles, y compris celles qui sont désactivées (une configuration BYOM désactivée est intéressante à afficher; dans le cas contraire, elle est insensible à une configuration qui n’a jamais été configurée).

Options

Drapeau	Objectif
--byo	Filtrez pour apporter uniquement vos propres garde-fous.

Exemples

uip agent guardrails list

uip agent guardrails list --byo

Format des données (--sortie json)

{
  "Code": "GuardrailDefinitionsList",
  "Data": [
    {
      "Validator": "pii_detection",
      "IsByo": false,
      "Status": "Available",
      "AllowedScopes": ["Agent", "Llm", "Tool"],
      "GuardrailStages": { "Agent": ["PreExecution", "PostExecution"], "Llm": ["PreExecution", "PostExecution"], "Tool": ["PreExecution", "PostExecution"] },
      "Parameters": [
        { "Type": "enum-list", "Id": "entities", "Required": true, "DefaultValue": ["Email", "Address"], "Options": ["Person", "Address", "Email", "..."] }
      ]
    }
  ]
}

Validator n'est pas unique — une définition BYOM peut partager un nom intégré (un locataire peut avoir deux harmful_content entrées). Utilisez IsByo plus les champs Byo* (ByoValidatorName, ByoConnectionId, ByoConfigurationId, ByoConnectorName, ByoConnectorKey, FolderKey) pour les différencier - ByoValidatorName et ByoConnectionId sont les deux qu'un agent codé transmet à ByoValidator(...).

garde-fous d'agent uip llm-as-judge-models

Répertoriez les modèles LLM disponibles pour le garde-fou LLM en tant que juge. Nécessite une connexion.

Exemple

uip agent guardrails llm-as-judge-models

Format des données (--sortie json)

{
  "Code": "LlmGatewayModelsList",
  "Data": [
    { "ModelId": "anthropic.claude-haiku-4-5-20251001-v1:0", "DisplayName": "Claude Haiku 4.5", "Vendor": "AwsBedrock", "ModelFamily": "AnthropicClaude", "SubscriptionType": "UiPathOwned", "IsByo": false, "IsPreview": false, "IsBlockedByPolicy": false }
  ]
}

Les modèles bloqués par la politique du locataire sont filtrés avant que la liste ne soit renvoyée.

Catalogue de garde-fous d’agent UiP

Récupérez les métadonnées du catalogue créées (descriptions, cas d'utilisation, exemples) pour les validateurs de garde-fous.

Options

Drapeau	Objectif
--validator <id>	Filtrez sur un validateur unique par son ID Paiement_incident (par exemple pii_detection).

Exemples

uip agent guardrails catalog

uip agent guardrails catalog --validator pii_detection

Format des données (--sortie json)

{
  "Code": "GuardrailCatalog",
  "Data": {
    "schema_version": "1.0.0",
    "guardrails": [
      { "validator_id": "pii_detection", "display_name": "PII Detection", "type": "BuiltIn", "status": "Available", "description": "...", "use_cases": ["..."], "examples": [] }
    ]
  }
}

Si la fonctionnalité de catalogue n'est pas encore activée pour le locataire, cela échoue avec Code: "GuardrailCatalogUnavailable".

Associé

• uip agent review — l'une de ses catégories de règles est guardrails

Voir également

• Authentification — requise pour llm-as-judge-models.
• Options globales, codes de sortie.