使用 Step Functions 調用 Amazon Bedrock AgentCore 繫帶

您可以將 Step Functions 與 Amazon Bedrock AgentCore 整合，以從狀態機器叫用繫帶。繫帶是一種受管執行期，可協調模型推論、工具使用和多轉對話。在工作流程 Studio 中，搜尋 AgentCore InvokeHarness 以尋找此狀態，並將其拖曳到您的工作流程。

從組態面板中，您可以使用 Quick Create Harness 建立新的繫帶和執行角色，或選取現有的繫帶 ARN。當您使用現有的繫帶時，可以覆寫每次呼叫的組態 – 任務狀態定義中的值會覆寫繫帶預設值。如需可用的參數，請參閱《Amazon Bedrock AgentCore API 參考》中的 InvokeHarness。如需利用執行角色的詳細資訊，請參閱《Amazon Bedrock AgentCore 開發人員指南》中的執行期許可。

若要了解如何在 Step Functions 中整合 AWS 服務，請參閱 整合 服務和 在 Step Functions 中將參數傳遞至服務 API。

最佳化 Amazon Bedrock AgentCore APIs

支援下列 API：

InvokeHarness

調用工具來執行 AI 代理程式，該代理程式可以使用工具、存取記憶體和執行多迴轉對話。

支援的模式：僅限請求回應。

如需完整的請求語法，請參閱《Amazon Bedrock AgentCore API 參考》中的 InvokeHarness。

回應欄位

回應語法

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

Amazon Bedrock AgentCore 整合的任務狀態定義

下列範例示範如何定義叫用 Amazon Bedrock AgentCore 繫帶的任務狀態。

RuntimeSessionId 欄位可識別對話工作階段。跨調用使用相同的工作階段 ID 以繼續對話。

{
  "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
}

錯誤處理

InvokeHarness API 可能會因為各種錯誤而失敗，包括限流、驗證和存取遭拒的錯誤。如需完整清單，請參閱《Amazon Bedrock AgentCore API 參考》中的 InvokeHarness 錯誤。

下列範例顯示使用 Retry和 Catch 欄位處理錯誤的任務狀態：

{
  "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
}

用於呼叫 Amazon Bedrock AgentCore 的 IAM 政策

下列範例範本顯示 如何根據狀態機器定義中的資源 AWS Step Functions 產生 IAM 政策。如需詳細資訊，請參閱Step Functions 如何為整合服務產生 IAM 政策及探索 Step Functions 中的服務整合模式。

Amazon Bedrock AgentCore 整合的 IAM 政策範例

下列範例示範如何為 Step Functions 執行角色建立 IAM 政策，以與 Amazon Bedrock AgentCore 資源互動。

在下列政策範例中，將預留位置值取代為您自己的值。

叫用特定集合的 IAM 政策

下列範例政策允許 ARN 叫用特定的 Amazon Bedrock AgentCore 繫帶。

{
    "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"
        }
    ]
}

IAM 政策可叫用 帳戶中的所有繫帶

下列範例政策允許調用您帳戶中的任何 Amazon Bedrock AgentCore 繫帶。我們建議您盡可能縮小到特定的固定 ARN。

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