AWS Bedrock AgentCore

Solo Enterprise for agentregistry カタログから AWS Bedrock AgentCore にエージェントをデプロイします。

始める前に

OIDC プロバイダーをセットアップして、ユーザーがレジストリで認証できるようにします。
AWS EKS クラスターに Solo Enterprise for agentregistry をインストールし、arctl CLI をセットアップします。
まだ実行していない場合は、Solo Enterprise for agentregistry サーバーをポート 12121 でポートフォワードします。レジストリはデフォルトでは外部に公開されないため、ローカルマシンから到達するにはポートフォワードが必要です。
```
kubectl -n agentregistry-system port-forward svc/agentregistry-enterprise-server 12121:12121
```

エージェントをデプロイする

Solo Enterprise for agentregistry UI のエージェントカタログを開き、デプロイするエージェントを選択します。
Deploy をクリックしてデプロイウィザードを開きます。
エージェントをデプロイするプロバイダーとリージョンを選択します。次に Deploy Agent をクリックします。
エージェントデプロイの Instance Logs セクションでデプロイの進捗状況を監視します。デプロイの完了には数分かかる場合があります。

Solo Enterprise for agentregistry に接続されているランタイムを一覧表示し、エージェントをデプロイするランタイムの名前をメモします。次の例では、ランタイム名は agentcore です。
```
arctl get runtimes
```
出力例:
```
NAME                 TYPE
agentcore            BedrockAgentCore
kubernetes-default   kubernetes
local                local
```

エージェント用の Deployment を作成します。レジストリは、エージェントをレジストリカタログに公開したときに指定した GitHub URL からエージェントのソースコードと Dockerfile を取得します。次に、レジストリはコードをパッケージ化し、AWS Bedrock AgentCore で実行できる互換イメージをビルドし、そのイメージを使用して VPC 内にランタイムをデプロイします。deploymentRefs フィールドはエージェントを MCP サーバーデプロイにリンクし、MCP ツール呼び出しがゲートウェイ経由で自動的にルーティングされるようにします。

arctl apply -f - <<EOF
apiVersion: ar.dev/v1alpha1
kind: Deployment
metadata:
  name: myagent
spec:
  targetRef:
    kind: Agent
    name: myagent
    tag: "latest"
  runtimeRef:
    kind: Runtime
    name: agentcore
  deploymentRefs:
    - name: mymcp
EOF

設定	説明
`targetRef`	デプロイするエージェント。
`runtimeRef`	デプロイ先のランタイム名。
`deploymentRefs`	エージェントデプロイをその MCP サーバーデプロイにリンクします。レジストリはこれを使用して MCP サーバーのゲートウェイバックエンドをエージェントに接続し、MCP ツール呼び出しがゲートウェイ経由でルーティングされるようにします。

出力例:

✓ Deployment/myagent created

UI で Instances ビューを開き、デプロイしたエージェントを選択します。Instance Logs セクションでデプロイの進捗状況を監視できます。デプロイの完了には数分かかる場合があります。

エージェントとチャットする

Solo Enterprise for agentregistry または AWS Bedrock AgentCore UI を使用してエージェントとチャットできます。

UI で Instances ビューを開き、myagent エージェントを選択します。
Agent Details カードで Open Chat をクリックします。
エージェントとチャットします。たとえば、エージェントに何ができるかを尋ねることができます。次に Enter キーを押し、エージェントからの応答を待ちます。

AWS Bedrock AgentCore のエージェント概要を開き、デプロイしたエージェントを選択します。
ENDPOINTS カードに移動し、Default エンドポイントをクリックします。
Test endpoint をクリックしてエージェントサンドボックスを開きます。
エージェントサンドボックスで、Runtime ドロップダウンからエージェントが選択されていることを確認します。

Input カードに次のプロンプトを入力し、Run をクリックします。エージェントから応答が返ってくることを確認します。

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "what can you do?"
        }
      ],
      "messageId": "msg-1",
      "contextId": "f5bd2a40-74b6-4f7a-b649-ea3f09890003"
    }
  }
}

出力例:

{
  "id": "1",
  "jsonrpc": "2.0",
  "result": {
     "artifacts": [
     {
         "artifactId": "11a1111a1-1a1a-1111-1a11-11a11aa11111",
         "parts": [
         {
             "kind": "text",
             "text": "I can roll dice of different sizes and check if numbers are prime. Just ask me to roll a die (specifying the number of sides) or ask me to check if a number is prime.\n"
         }
         ]
     }
...

Solo Enterprise for kagent