コンテンツにスキップ

2. CLIでエージェントを作成

antというClaude Platform CLIを使ってエージェントを作成します。1. コンソールでエージェントを作成で画面から作った構成(環境 → エージェント → セッション)と同じものを、すべてantコマンドで作成します。

  1. antをインストールします。

    1. antのリリースページより、ant_{バージョン番号}_windows_amd64.zipをダウンロードします。

    2. 任意の場所に展開します。

    3. 展開したフォルダーでpowershell.exeを起動します。

    4. コマンド出力の日本語が文字化けしないよう、文字コードをUTF-8に設定します。

      Terminal window
      $OutputEncoding = [Console]::OutputEncoding = New-Object System.Text.UTF8Encoding $false
  2. ant auth loginを実行します。

    1. 以下のコマンドを実行します。
      Terminal window
      ./ant auth login
  3. ブラウザでログインします。

コンソール版と名前が重複しないよう、CLI版の名前には「-cli」を付けています。

  1. MCPサーバーへのネットワークアクセスを許可した環境を作成し、IDを変数に保存します(コマンドは1行です)。

    Terminal window
    $ENVIRONMENT_ID = ./ant beta:environments create --name "Quiz-environment-cli" --config '{type: cloud, networking: {type: limited, allow_mcp_servers: true}}' --transform id --raw-output

    変数の中身を表示して、env_で始まるIDが保存されていることを確認します。

    Terminal window
    $ENVIRONMENT_ID
  1. コマンドを実行しているフォルダーにagent.yamlという名前のファイルを作成し、以下の内容を保存します。

    agent.yaml
    name: AZ-900 Quiz Agent CLI
    model:
    id: claude-haiku-4-5
    speed: standard
    description: Microsoft Learn MCPサーバーの最新情報を使ってAZ-900(Azure Fundamentals)の練習問題を出題する学習アシスタント。
    system: |-
    あなたはMicrosoft Learn MCPサーバーを使ってAZ-900(Azure Fundamentals)の練習問題を作成する学習アシスタントです。Microsoft Learnの最新の公式ドキュメントを参照し、選択式の問題を1問ずつ出題してください。
    ルール:
    - 問題文と選択肢を提示したら、ユーザーが回答するまで正解を明かさない。
    - ユーザーの回答後、正誤を伝え、各選択肢について正誤のポイントを1行ずつで説明する。
    - 学習の参考になるMicrosoft Learnドキュメントの実在するURLを3つ提示する。
    - 会話内でユーザーの過去の回答(正解・不正解、出題分野)を記憶し、間違えた分野・苦手なトピックを優先的に次の問題として出題する。
    - 一度に1問だけ出題し、テンポよく進める。
    mcp_servers:
    - name: microsoft-learn
    type: url
    url: https://learn.microsoft.com/api/mcp
    tools:
    - type: mcp_toolset
    mcp_server_name: microsoft-learn
    default_config:
    enabled: true
    permission_policy:
    type: always_allow
    skills: []
    metadata: {}
  2. agent.yamlを読み込ませてエージェントを作成し、IDを変数に保存します。

    Terminal window
    $AGENT_ID = Get-Content agent.yaml -Raw -Encoding UTF8 | ./ant beta:agents create --transform id --raw-output

    変数の中身を表示して、agent_で始まるIDが保存されていることを確認します。

    Terminal window
    $AGENT_ID
  1. ここまでで保存した2つのIDが揃っていることを確認します。

    Terminal window
    $AGENT_ID; $ENVIRONMENT_ID
  2. エージェントと環境のIDを指定してセッションを作成し、IDを変数に保存します(コマンドは1行です)。認証情報ボールトは不要なので、--vault-idは指定しません。

    Terminal window
    $SESSION_ID = ./ant beta:sessions create --agent $AGENT_ID --environment-id $ENVIRONMENT_ID --transform id --raw-output

    変数の中身を表示して、sesn_で始まるIDが保存されていることを確認します。

    Terminal window
    $SESSION_ID
  1. ターミナルを2つ使い、片方でイベントをリアルタイムに受信しながら、もう片方からメッセージを送信します。まず、これまで使ってきたウィンドウ(ターミナル1)でイベントのストリーム受信を開始します。

    Terminal window
    ./ant beta:sessions:events stream --session-id $SESSION_ID --format jsonl

    コマンドは実行したまま、イベントが届くのを待ち受けます。--format jsonlを付けているので、イベントは1行ずつJSON形式で表示されます。

  2. 新しいウィンドウ(ターミナル2)を開き、送信の準備をします。変数はウィンドウごとに独立しているため、ターミナル2にも$SESSION_IDを設定します。ここにセッションIDの部分は、4. セッションを作成で表示したsesn_から始まるIDに置き換えてください(ターミナル1の画面をさかのぼると確認できます)。

    antを展開したフォルダーで新しくPowerShellを起動し、以下を実行します。

    Terminal window
    $OutputEncoding = [Console]::OutputEncoding = New-Object System.Text.UTF8Encoding $false
    $SESSION_ID = "ここにセッションID"
  3. ターミナル2からメッセージを送信します(コマンドは1行です)。

    Terminal window
    ./ant beta:sessions:events send --session-id $SESSION_ID --event '{type: user.message, content: [{type: text, text: "AZ-900の練習問題を1問出題してください"}]}'

    送信すると、ターミナル1にuser.messageをはじめとするイベントが流れ始めます。MCPツールの呼び出し(agent.mcp_tool_use)に続いて、agent.messageイベントのtextとして問題が届きます。session.status_idleが表示されたら完了です。

  4. 同じセッションに回答を送ると、正誤判定が返ってきます。セッションはステートフルなので、直前に出題された問題を覚えています。Cの部分は自分の回答に置き換えてください。

    Terminal window
    ./ant beta:sessions:events send --session-id $SESSION_ID --event '{type: user.message, content: [{type: text, text: "C"}]}'

    回答を確認できたら、ターミナル1でCtrl+Cを押してストリームを終了してください。

    表示を見逃した場合は、イベント履歴から確認できます。イベントが1行ずつ表示され、agent.messageの行のtextが回答です。

    Terminal window
    ./ant --format jsonl --transform '{type,text:content.0.text}' beta:sessions:events list --session-id $SESSION_ID
  5. コンソールの「セッション」メニューから同じセッションを開くと、画面上でもやり取りを確認できます。

  • コンソールで作ったものと同じ構成(環境 → エージェント → セッション)を、antコマンドだけで再現しました。
  • ベータ版APIはbeta:プレフィックスのコマンドで呼び出します。--transform id --raw-outputでレスポンスからIDだけを取り出し、変数で次のコマンドに受け渡しました。
  • 設定は1行のフラグ(--configや--event)でも、YAMLファイル(agent.yaml)でも渡せます。
  • セッションとのやり取りは、events sendで送信し、events stream(または履歴の取得)で確認します。同じセッションに送り続けると、出題 → 回答 → 正誤判定の会話がつながります。

おつかれさまでした!ここまでの感想を、ぜひXにポストしてください。

感想をXにポストする