コンテンツにスキップ
これは最新の機能を備えた最新リリースですが、長期サポートは提供されません。サポートを継続するには、新しいリリースごとにアップグレードするか、四半期ごとの安定版リリースをご利用ください。

For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Solo Enterprise for kagent

Page as Markdown

Solo Enterprise for kagent を使用して Kubernetes クラスターにエージェントをデプロイします。

始める前に

  1. Solo Enterprise for kagent クイックスタートに従って、Solo Enterprise for agentregistry をセットアップし、Solo Enterprise for kagent をランタイムとして接続します。

  2. エージェントを作成します。

  3. Docker コンテナイメージをビルドし、クラスターがプルできるコンテナレジストリにプッシュします。

  4. エージェントを公開します。

  5. ローカルマシンで Solo Enterprise for agentregistry サービスをポートフォワードします。

    kubectl -n agentregistry-system port-forward svc/agentregistry-enterprise-server 12121:12121

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

  1. Solo Enterprise for agentregistry に接続されているランタイムを一覧表示し、エージェントをデプロイするランタイムの名前をメモします。次の例では、ランタイム名は kagent です。

    arctl get runtimes

    出力例:

    NAME     TYPE
    kagent   Kagent
    
  2. Gemini API キーを環境変数として保存します。API キーを取得するには、Google AI Studio にログインして API Keys を選択します。このキーは、後で Gemini LLM プロバイダーを介してエージェントと対話するために必要です。

    export GOOGLE_API_KEY=<apikey>
  3. エージェント用の Deployment を作成します。レジストリは、レジストリカタログに保存されている Docker イメージ参照からエージェント用の Kubernetes Pod を起動します。env 設定は Gemini API キーをエージェントコンテナに渡し、デプロイ後にエージェントが Gemini API を呼び出せるようにします。

    arctl apply -f - <<EOF
    apiVersion: ar.dev/v1alpha1
    kind: Deployment
    metadata:
      name: myagent       # must match agent's metadata.name
    spec:
      targetRef:
        kind: Agent
        name: myagent
        tag: "latest"
      runtimeRef:
        kind: Runtime
        name: kagent
      env:
        GOOGLE_API_KEY: "$GOOGLE_API_KEY"
    EOF
    設定説明
    targetRefデプロイする AI アーティファクト。この例では、レジストリカタログで公開されている myagent エージェントをデプロイします。
    runtimeRefデプロイ先のランタイム名。
    envデプロイ後にエージェントが Gemini API を呼び出せるよう、Gemini API キーを環境変数としてエージェントコンテナに渡します。

    出力例:

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

  5. クラスター内のエージェントデプロイを確認し、Pod が稼働していることを確認します。

    kubectl get pods -n kagent | grep myagent

    出力例:

    myagent-85bf9949c9-gp49h   1/1     Running                      0          5m35s

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

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

  1. UI で Instances ビューを開き、myagent エージェントを選択します。

  2. Agent Details カードで Open Chat をクリックします。

  3. エージェントとチャットします。たとえば、エージェントに何ができるかを尋ねることができます。次に Enter キーを押し、エージェントからの応答を待ちます。

次のステップ