As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Use um AgentCore gateway com política em AgentCore

Siga o guia de autorização e autenticação do gateway para obter as credenciais necessárias para o acesso ao gateway.

Listar ferramentas de AgentCore gateway com política em AgentCore

A listagem de ferramentas é tratada como uma meta-ação. Quando um diretor lista as ferramentas disponíveis, o mecanismo de política não avalia o contexto completo da invocação de uma ferramenta específica (por exemplo, parâmetros de entrada).

O diretor só pode ver na lista as ferramentas para as quais ele poderia ligar de acordo com a política. Como o contexto completo de uma chamada de ferramenta não está disponível durante a listagem, isso significa que o diretor pode listar uma ferramenta se houver algum conjunto de circunstâncias em que uma chamada para essa ferramenta seja permitida.

Como resultado, uma ferramenta que aparece na lista não garante que uma chamada subsequente para essa ferramenta seja autorizada. A decisão de autorização para uma invocação real da ferramenta é avaliada separadamente usando o contexto completo da solicitação, incluindo parâmetros de entrada.

Selecione um dos seguintes métodos:

Ferramentas de gateway de chamadas com política

Faça chamadas de ferramentas para seu gateway. A avaliação da política determina se a chamada é permitida ou negada.

Selecione um dos seguintes métodos:

Passando o ID da sessão de política para políticas temporais

Para ativar a avaliação da política temporal, inclua o x-amzn-bedrock-agentcore-policy-session-id cabeçalho em suas solicitações. Isso agrupa várias invocações em uma única sessão para a aplicação de políticas com reconhecimento de sessão.

curl -X POST \
  https://mygateway-abcdefghij.gateway.bedrock-agentcore.us-west-2.amazonaws.com/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "x-amzn-bedrock-agentcore-policy-session-id: YOUR_SESSION_ID" \
  -d '{
    "jsonrpc": "2.0",
    "id": "test-temporal-policy",
    "method": "tools/call",
    "params": {
      "name": "tool_name",
      "arguments": {arguments}
    }
  }'

O Gateway não gera um ID de sessão em seu nome. Você deve gerar o ID da sessão e enviá-lo em cada solicitação, começando com sua primeira solicitação. Se você omitir o cabeçalho ou enviar um valor vazio, o Gateway não estabelecerá uma sessão. Se o mecanismo de política associado contiver uma política temporal, as solicitações sem um ID de sessão falharão com um erro de validação. Envie o mesmo ID com todas as solicitações na mesma sessão.

Respostas políticas

Quando uma política permite a solicitação:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "isError": false,
    "content": [
      {
        "type": "text",
        "text": "ToolResult"
      }
    ]
  }
}

Quando uma política nega a solicitação:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "AuthorizeActionException - Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"
      }
    ],
    "isError": true
  }
}