ハーネスエージェントを作成する

プラグイン、スキル、指示を参照する Agent 定義を作成し、カタログに公開します。

始める前に

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

エージェントのアーティファクトを準備する

サンプルのアーティファクトをいくつかカタログに追加します。Agent リソースで参照するアーティファクトは、エージェントハーネスをデプロイする前にすべてカタログに存在している必要があります。

プラグイン定義ファイルを作成し、プラグインをレジストリに公開します。次の例では、Solo.io の doc-examples リポジトリから hello-plugin を使用します。

arctl apply -f- <<EOF
apiVersion: ar.dev/v1alpha1
kind: Plugin
metadata:
  name: hello-plugin
spec:
  title: Hello Plugin
  description: A simple test plugin with a /hello slash command.
  harnesses:
    - claude-code
  source:
    type: git
    git:
      repository:
        url: https://github.com/solo-io/doc-examples
        branch: main
        subfolder: agentregistry/plugin
EOF

Solo.io ドキュメントの MCP サーバーを登録します。

arctl apply -f- <<EOF
apiVersion: ar.dev/v1alpha1
kind: MCPServer
metadata:
  name: solo-docs
spec:
  title: Solo.io docs MCP
  description: "MCP server for Solo.io product documentation."
  remote:
    type: streamable-http
    url: https://search.solo.io/mcp
EOF

エージェントのシステムプロンプトとして使用するプロンプトを作成します。

arctl apply -f- <<EOF
apiVersion: ar.dev/v1alpha1
kind: Prompt
metadata:
  name: my-prompt
spec:
  title: My Prompt
  description: System prompt for the hello agent.
  content: You are a helpful coding assistant with access to Solo.io product documentation.
EOF

スキルを作成します。次の例では、Solo.io の doc-examples リポジトリから myskill スキルを使用します。

arctl apply -f- <<EOF
apiVersion: ar.dev/v1alpha1
kind: Skill
metadata:
  name: myskill
spec:
  title: myskill
  description: A sample skill that demonstrates the echo skill template.
  source:
    repository:
      url: https://github.com/solo-io/doc-examples
      branch: main
      subfolder: agentregistry/myskill
EOF

アーティファクトが作成されたことを確認します。

arctl get all

出力例:

mcps
NAME                TAG      DESCRIPTION
solo-docs           latest   MCP server for Solo.io product documentation.

skills
NAME      TAG      DESCRIPTION
myskill   latest   A sample skill that demonstrates the echo skill te...

prompts
NAME        TAG      DESCRIPTION
my-prompt   latest   System prompt for the hello agent.

plugins
NAME           TAG      DESCRIPTION
hello-plugin   latest   A simple test plugin with a /hello slash command.

ハーネスエージェントを作成する

Agent リソースを使用してハーネスエージェントを定義します。

エージェント定義ファイルを作成し、レジストリカタログに適用します。次の例では、プラグイン、MCP サーバー、スキル、プロンプト (指示) からエージェントを構成します。

arctl apply -f- <<EOF
apiVersion: ar.dev/v1alpha1
kind: Agent
metadata:
  name: hello-agent
spec:
  title: Hello Agent
  description: A sample coding assistant composed from a plugin, skill, MCP server, and system prompt.
  compatibleHarnesses:
    - type: claude-code
  plugins:
    - name: hello-plugin
      tag: latest
  skills:
    - name: myskill
      tag: latest
  instructions:
    name: my-prompt
    tag: latest
  mcpServers:
    - name: solo-docs
      tag: latest
EOF

フィールド	説明
`spec.compatibleHarnesses[].type`	このエージェントが動作するように設計されたハーネス。指定できる値は `claude-code` と `openclaw` です。
`spec.plugins[].name`	含める公開済みプラグインのカタログ名。レジストリはプラグインのピン留めされたコミットを解決し、デプロイ時にバンドルを実体化します。プラグインは、`spec.compatibleHarnesses[].type` で定義したハーネスで実行できる必要があります。
`spec.skills[].name`	含める公開済みスキルのカタログ名。
`spec.instructions.name`	エージェントのシステムプロンプトとして使用する、公開済みプロンプトのカタログ名。
`spec.mcpServers[].name`	エージェントに追加する公開済み MCP サーバーのカタログ名。プラグインバンドル内で宣言されていない、カタログレベルの MCP サーバーに使用します。

出力例:

✓ Agent/hello-agent (latest) created

エージェントがカタログに表示されることを確認します。

arctl get agent

出力例:

NAME          TAG      DESCRIPTION
hello-agent   latest   A sample coding assistant composed from a plugin, skill, ...

次のステップ

AWS Bedrock AgentCore にデプロイする AWS Bedrock AgentCore でハーネスエージェントを実行する Deployment を作成します。

ハーネスエージェントについてデプロイ