Invoque o Amazon Bedrock AgentCore Harness com Step Functions

Você pode integrar o Step Functions com o Amazon Bedrock AgentCore para invocar um arnês de sua máquina de estado. Um arnês é um tempo de execução gerenciado que orquestra a inferência de modelos, o uso de ferramentas e conversas em vários turnos. No Workflow Studio, pesquise AgentCore InvokeHarnesspara encontrar esse estado e arraste-o para o seu fluxo de trabalho.

No painel de configuração, você pode criar um novo arnês e uma função de execução usando o Quick Create Harness ou selecionar um ARN de chicote existente. Ao usar um equipamento existente, você pode substituir as configurações por invocação — os valores na definição do estado da tarefa substituem os padrões do equipamento. Para ver os parâmetros disponíveis, consulte InvokeHarnessa Referência da AgentCore API Amazon Bedrock. Para obter mais informações sobre como aproveitar as funções de execução, consulte Permissões de tempo de execução no Amazon Bedrock AgentCore Developer Guide.

Para saber mais sobre a integração com AWS serviços no Step Functions, consulte Integração de produtos da e. Transmitir parâmetros a uma API de serviço no Step Functions

O Amazon Bedrock otimizou as APIs de AgentCore aproveitamento

A seguinte API é compatível:

InvokeHarness

Invoca um equipamento para executar um agente de IA que pode usar ferramentas, acessar a memória e executar conversas em vários turnos.

Padrão suportado: somente Solicitar resposta.

Para ver a sintaxe completa da solicitação, consulte InvokeHarnessa Amazon Bedrock AgentCore API Reference.

Campos de resposta

Sintaxe da resposta

{
  "Output": {
    "Message": {
      "Role": "string",
      "Content": [
        {
          "Text": "string"
        }
      ]
    }
  },
  "StopReason": "string",
  "Usage": {
    "InputTokens": long,
    "OutputTokens": long,
    "TotalTokens": long
  },
  "Metrics": {
    "LatencyMs": long
  }
}

Definição do estado da tarefa para integração com o Amazon Bedrock AgentCore

Os exemplos a seguir mostram como definir um estado de tarefa que invoca um arnês Amazon Bedrock AgentCore .

O RuntimeSessionId campo identifica a sessão de conversação. Use o mesmo ID de sessão em todas as invocações para continuar uma conversa.

{
  "Type": "Task",
  "Resource": "arn:aws:states:::bedrockagentcore:invokeHarness",
  "Arguments": {
    "HarnessArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:harness/my-agent-harness",
    "RuntimeSessionId": "{% $uuid() %}",
    "Messages": [
      {
        "Content": [{ "Text": "{% $states.input.userMessage %}" }],
        "Role": "user"
      }
    ],
    "SystemPrompt": [{ "Text": "You are a helpful customer service agent." }],
    "Model": {
      "BedrockModelConfig": {
        "Temperature": 0.7,
        "ModelId": "global.anthropic.claude-sonnet-4-6"
      }
    },
    "MaxIterations": 75,
    "TimeoutSeconds": 600
  },
  "End": true
}

{
  "Type": "Task",
  "Resource": "arn:aws:states:::bedrockagentcore:invokeHarness",
  "Arguments": {
    "HarnessArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:harness/order-agent",
    "RuntimeSessionId": "{% $uuid() %}",
    "Messages": [
      {
        "Content": [{ "Text": "What is the status of order #12345?" }],
        "Role": "user"
      }
    ],
    "Tools": [
      {
        "Type": "agentcore_browser",
        "Name": "aws_browser_v1",
        "Config": {
          "AgentCoreBrowser": {
            "BrowserArn": "arn:aws:bedrock-agentcore:us-east-1:aws:browser/aws.browser.v1"
          }
        }
      }
    ],
    "MaxIterations": 10,
    "TimeoutSeconds": 300
  },
  "End": true
}

Tratamento de erros

A InvokeHarness API pode falhar com uma variedade de erros, incluindo erros de limitação, validação e acesso negado. Para obter uma lista completa, consulte InvokeHarnessos erros na referência da AgentCore API Amazon Bedrock.

O exemplo a seguir mostra um estado de tarefa com Retry Catch campos para tratamento de erros:

{
  "Type": "Task",
  "Resource": "arn:aws:states:::bedrockagentcore:invokeHarness",
  "Arguments": {
    "HarnessArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:harness/my-harness",
    "Messages": [
      {
        "Content": [{ "Text": "{% $states.input.userMessage %}" }],
        "Role": "user"
      }
    ]
  },
  "Retry": [
    {
      "ErrorEquals": ["BedrockAgentCore.ThrottlingException"],
      "IntervalSeconds": 2,
      "MaxAttempts": 3,
      "BackoffRate": 2.0
    }
  ],
  "Catch": [
    {
      "ErrorEquals": ["BedrockAgentCore.ResourceNotFoundException"],
      "Next": "HandleNotFound"
    },
    {
      "ErrorEquals": ["States.ALL"],
      "Next": "HandleError"
    }
  ],
  "End": true
}

Políticas do IAM para ligar para o Amazon Bedrock AgentCore

Os modelos de exemplo a seguir mostram como AWS Step Functions gera políticas do IAM com base nos recursos na definição da sua máquina de estado. Para obter mais informações, consulte Como o Step Functions gera políticas do IAM para serviços integrados e Descobrir padrões de integração de serviços no Step Functions.

Exemplos de políticas do IAM para integração com o Amazon Bedrock AgentCore

Os exemplos a seguir mostram como você pode criar políticas do IAM para que sua função de execução de Step Functions interaja com os AgentCore recursos do Amazon Bedrock.

Nos exemplos de políticas a seguir, substitua os valores do espaço reservado pelos seus próprios valores.

Política do IAM para invocar um equipamento específico

O exemplo de política a seguir permite invocar um arnês Amazon Bedrock específico AgentCore pelo ARN.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "InvokeSpecificHarness",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:InvokeHarness",
                "bedrock-agentcore:InvokeAgentRuntime"
            ],
            "Resource": "arn:aws:bedrock-agentcore:region:accountId:harness/harnessName"
        }
    ]
}

Política do IAM para invocar todos os chicotes em uma conta

O exemplo de política a seguir permite invocar qualquer AgentCore arnês Amazon Bedrock em sua conta. Recomendamos reduzir o escopo até um ARN de arnês específico, quando possível.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "InvokeAllHarnesses",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:InvokeHarness",
                "bedrock-agentcore:InvokeAgentRuntime"
            ],
            "Resource": "arn:aws:bedrock-agentcore:region:accountId:harness/*"
        }
    ]
}