モデルを公開する

Model リソースを定義してレジストリカタログに公開し、ハーネスエージェントがデプロイ時に参照できるようにします。

モデル は、ハーネスエージェントが呼び出す AI モデルと、モデルプロバイダーでの認証方法を宣言する、バージョン管理されたカタログエントリです。ハーネスエージェントをデプロイすると、レジストリはカタログからモデル構成を読み取り、ハーネスランナーに渡します。これにより、ランナーは呼び出すエンドポイントと使用する認証情報を判別できます。

Note

モデルが必要なのはハーネスエージェントだけです。現時点でハーネスエージェントは AWS Bedrock AgentCore ランタイムでのみサポートされるため、サポートされるモデルプロバイダーは AWS Bedrock だけです。ここで定義するモデルは、使用する Bedrock の推論プロファイルをハーネスランナーに伝えます。自分でビルドしてパッケージ化する BYO エージェントは、コンテナーイメージ内で独自のモデル構成を管理します。

始める前に

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
```

ハーネスエージェントをデプロイする予定の AWS リージョンを環境変数に保存します。使用する Bedrock モデルがこのリージョンで利用できることを確認してください。この値はモデル定義で使用します。
```
export AWS_REGION=<aws-region>
```

モデルを作成して公開する

プラットフォーム管理者は、モデルをカタログに公開することで、ハーネスエージェントをデプロイする担当者が使用できるモデルを制御します。デプロイ担当者は、公開されたモデルをハーネスエージェントのデプロイで名前によって参照できます。

このガイドの例では、モデルをセットアップしてレジストリカタログに公開する手順を説明します。組織全体のデフォルトモデルを設定する場合は、組織のデフォルトモデルを設定するを参照してください。

モデル定義を作成し、レジストリカタログにプッシュします。次の例では claude-sonnet-4-6 モデルを使用します。選択したモデルが対象の AWS リージョンでサポートされていることを確認してください。

arctl apply -f - <<EOF
apiVersion: ar.dev/v1alpha1
kind: Model
metadata:
  name: claude-sonnet-4
spec:
  title: Claude Sonnet 4
  provider: bedrock
  model: us.anthropic.claude-sonnet-4-6
  auth:
    strategy: runtime
  endpoint:
    region: $AWS_REGION
EOF

フィールド	説明
`spec.title`	カタログ UI に表示される、人が読みやすい表示名。
`spec.description`	任意。カタログ一覧に表示される説明。
`spec.provider`	モデルプロバイダー。現在は `bedrock` (AWS Bedrock) のみサポートしています。
`spec.model`	使用するモデル ID。AWS Bedrock の場合は推論プロファイル ID です (例: `us.anthropic.claude-sonnet-4-6`)。サポートされるモデルとリージョンごとの提供状況については、AWS Bedrock のドキュメントを参照してください。
`spec.auth.strategy`	ハーネスランナーがモデルプロバイダーで認証する方法。AWS Bedrock AgentCore 上のハーネスデプロイでは `runtime` を使用します。`runtime` の場合、ハーネスランナーは AgentCore 実行ロールの IAM 権限を使用して Bedrock にアクセスします。API キーは不要です。
`spec.endpoint.region`	Bedrock API 呼び出しを行う AWS リージョン。`spec.model` で選択したモデルがこのリージョンで利用できる必要があります。ハーネスエージェントをデプロイする予定のリージョンと同じものを使用します。

出力例:

✓ Model/claude-sonnet-4 (latest) created

モデルがカタログに作成されたことを確認します。

arctl get models

出力例:

NAME               TAG      PROVIDER   MODEL                              AUTH
claude-sonnet-4    latest   bedrock    us.anthropic.claude-sonnet-4-6     runtime

組織のデフォルトモデルを設定する

プラットフォーム管理者は、Model リソースに default という名前を付けることで、すべてのハーネスエージェントのデプロイがデフォルトで使用するモデルを設定できます。これにより、ハーネスエージェントのデプロイで Model 構成を参照する必要がなくなります。

arctl apply -f - <<EOF
apiVersion: ar.dev/v1alpha1
kind: Model
metadata:
  name: default
spec:
  title: Organization default model
  provider: bedrock
  model: us.anthropic.claude-sonnet-4-6
  auth:
    strategy: runtime
  endpoint:
    region: $AWS_REGION
EOF

次のステップ

ハーネスエージェントを作成するプラグイン、スキル、指示からハーネスエージェントを構成し、カタログに公開します。 AWS Bedrock AgentCore にハーネスエージェントをデプロイするモデルを参照するハーネスエージェントの Deployment を作成します。