Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Génération de politiques : validation par politique

Lorsque vous utilisez le service de création de politiques pour générer des politiques à partir du langage naturel, la validation et l'analyse sont effectuées par politique individuelle lors de la génération.

Comment ça marche

Exemple : générer et valider une politique

La récupération des résultats de génération se fait en deux étapes : vérifiez d'abord l'état de la génération, puis dressez la liste des actifs générés pour voir les politiques et leurs résultats de validation.

Lancez la génération d'une politique :

aws bedrock-agentcore-control start-policy-generation \
  --policy-engine-id MyEngine-abc123 \
  --name RefundPolicy \
  --content '{
    "rawText": "Allow customer service agents to process refunds up to 500 dollars for orders placed within the last 30 days"
  }' \
  --resource '{
    "arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/MyGateway-xyz789"
  }'

La réponse inclut un identifiant et un statut de génération de politique :

{
  "policyGenerationId": "RefundPolicy-def456",
  "policyEngineId": "MyEngine-abc123",
  "status": "GENERATING"
}

Vérifiez l'état de la génération à l'aide de get-policy-generation :

aws bedrock-agentcore-control get-policy-generation \
  --policy-engine-id MyEngine-abc123 \
  --policy-generation-id RefundPolicy-def456

La réponse indique l'état général de la génération :

{
  "policyGenerationId": "RefundPolicy-def456",
  "status": "GENERATED",
  "statusReasons": []
}

Une fois le statut définiGENERATED, répertoriez les actifs générés pour récupérer les politiques et leurs résultats de validation par politique :

aws bedrock-agentcore-control list-policy-generation-assets \
  --policy-engine-id MyEngine-abc123 \
  --policy-generation-id RefundPolicy-def456

La réponse inclut chaque politique générée avec sa définition Cedar et ses résultats de validation :

{
  "policyGenerationAssets": [
    {
      "policyGenerationAssetId": "asset-1",
      "definition": {
        "cedar": {
          "statement": "permit(\n  principal is AgentCore::OAuthUser,\n  action == AgentCore::Action::\"RefundTool___process_refund\",\n  resource == AgentCore::Gateway::\"arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/MyGateway-xyz789\"\n) when {\n  context.input.amount <= 500\n};"
        }
      },
      "findings": [
        {
          "type": "VALID"
        }
      ],
      "rawTextFragment": "Allow customer service agents to process refunds up to 500 dollars"
    },
    {
      "policyGenerationAssetId": "asset-2",
      "definition": {
        "cedar": {
          "statement": "permit(\n  principal,\n  action == AgentCore::Action::\"RefundTool___view_order_history\",\n  resource\n);"
        }
      },
      "findings": [
        {
          "type": "ALLOW_ALL",
          "description": "Overly Permissive: Policy Engine will allow every request for the specified principal (AgentCore::OAuthUser), action (RefundTool___view_order_history) and resource (gateway/*) combination if the policy is added or updated"
        }
      ],
      "rawTextFragment": "Allow customer service agents to view order history"
    }
  ]
}

Résultats de validation par politique

Chaque actif de politique généré comprend un findings tableau d'Findingobjets, chacun étant doté d'un type etdescription. Les exemples suivants présentent différents types de résultats :

Une politique qui a été validée et analysée avec succès :

{
  "findings": [
    {
      "type": "VALID"
    }
  ]
}

Une politique considérée comme trop permissive :

{
  "findings": [
    {
      "type": "ALLOW_ALL",
      "description": "Overly Permissive: Policy Engine will allow every request for the specified principal (AgentCore::OAuthUser), action (RefundTool___view_order_history) and resource (gateway/*) combination if the policy is added or updated"
    }
  ]
}

Une politique qui n'a pas pu être générée à partir de la saisie en langage naturel :

{
  "findings": [
    {
      "type": "NOT_TRANSLATABLE",
      "description": "Unsupported Condition Error: The request includes conditions that rely on data or attributes currently not supported."
    }
  ]
}

Constatations communes pour les politiques générées

Le tableau suivant décrit les types de recherche qui peuvent être renvoyés pour les politiques générées :