エージェントの組み立て

「メール署名を作る役割で動かしたい」と決めても、単にツールを渡すだけでは、モデルは丁寧な挨拶文を返したり、「以下のとおりです」といった前置きや後書きを付けたり、情報が足りないときに同じ質問を何度も返したりします。

1. 概要

「メール署名を作る役割で動かしたい」と決めても、単にツールを渡すだけでは、モデルは丁寧な挨拶文を返したり、「以下のとおりです」といった前置きや後書きを付けたり、情報が足りないときに同じ質問を何度も返したりします。エージェントに「どういう役割で、どういう手順で、どういう形式で応答してほしいか」を明示する仕組みが必要になります。

Strands の Agent クラスに渡す system_prompt(システムプロンプト)に、モデルが取るべき手順を箇条書きで書き込めば、エージェントの人格・応答方針・情報不足時の振る舞いを宣言的に指定できます。「単に丁寧に答えて」ではなく「1. 4項目を抽出、2. 揃えばツール呼び出し、3. 結果をそのまま返す」のように手順化するのがコツです。

ここではシステムプロンプトを詳細化して、応答を引き締めてみます。

2. コードの書き換え

main.py を、以下の内容で全体を置き換えて保存します。前セクションからの変更は、Agent(...) の system_prompt を手順書式にした箇所のみです。

from bedrock_agentcore.runtime import BedrockAgentCoreApp
from strands import Agent, tool
from strands.models import BedrockModel

COMPANY_NAME = "DevOps株式会社"
COMPANY_TEL = "03-1234-5678"
MODEL_ID = "<モデルID>"  # ap-northeast-1で利用可能なClaude Sonnetの推論プロファイルID(例: jp.anthropic.claude-sonnet-4-6)に変更してください

app = BedrockAgentCoreApp()


@tool
def create_signature(name: str, department: str, position: str, email: str) -> str:
    """ユーザからメール署名の作成を依頼されたときに使ってください。氏名・部署名・役職・メールアドレスを受け取り、所定のフォーマットのメール署名を返します。会社名と代表電話番号は Runtime 側で自動的に付与されるため、ユーザに問い合わせる必要はありません。

    Args:
        name: 氏名(例: '田中太郎')
        department: 部署名(例: '開発部')
        position: 役職(例: 'エンジニア')
        email: メールアドレス(例: 'tanaka@example.com')
    """
    return (
        "━━━━━━━━━━━━━━━━━━━━━━\n"
        f"【{name}】{COMPANY_NAME} {department} {position}\n"
        f"Email: {email}\n"
        f"Tel:   {COMPANY_TEL}\n"
        "━━━━━━━━━━━━━━━━━━━━━━"
    )


agent = Agent(
    model=BedrockModel(model_id=MODEL_ID, region_name="ap-northeast-1"),
    tools=[create_signature],
    system_prompt=(
        "あなたはメール署名を作成するアシスタントです。以下の手順で回答してください。\n"
        "1. ユーザの依頼から氏名・部署名・役職・メールアドレスの4項目を抽出する\n"
        "2. 4項目が揃っていれば create_signature ツールを呼び出す\n"
        "3. ツールの結果をそのまま提示する。挨拶文や『以下のとおりです』などの前置き・後書きは付けない\n"
        "4. 4項目のいずれかが揃わなければ、不足している項目だけを箇条書きでユーザに1度確認する"
    ),
)


@app.entrypoint
def invoke(payload):
    prompt = payload.get("prompt", "田中太郎(開発部 エンジニア、tanaka@example.com)のメール署名を作って")
    result = agent(prompt)
    return {"result": str(result)}


if __name__ == "__main__":
    app.run()

3. コードの解説

コードを解説します。前セクションからの変更点は Agent(...) の system_prompt の1箇所のみなので、その部分を抜粋して見ていきます。

    system_prompt=(
        "あなたはメール署名を作成するアシスタントです。以下の手順で回答してください。\n"
        "1. ユーザの依頼から氏名・部署名・役職・メールアドレスの4項目を抽出する\n"
        "2. 4項目が揃っていれば create_signature ツールを呼び出す\n"
        "3. ツールの結果をそのまま提示する。挨拶文や『以下のとおりです』などの前置き・後書きは付けない\n"
        "4. 4項目のいずれかが揃わなければ、不足している項目だけを箇条書きでユーザに1度確認する"
    ),

システムプロンプトを、モデルが取るべき手順の番号付き箇条書きに書き換えました。手順1・2 でツールの呼び出し条件(4項目が揃えばツールを呼ぶ)を明示し、手順3 で応答フォーマット(ツール結果のまま提示、前置き・後書き禁止)を指定、手順4 で情報不足時の振る舞い(不足項目だけを箇条書きで1度確認する)を指定しています。

このように「エージェントに何をしてほしいか」を手順化してシステムプロンプトに書くと、応答のブレが小さくなり、実運用に耐える振る舞いに近づきます。ツール呼び出しループそのものは Strands が自動で回してくれるので、書き手はこの「振る舞いの宣言」に集中できます。

4. 動作確認

まず、情報が揃った質問を送ります。

田中太郎(開発部 エンジニア、tanaka@example.com)のメール署名を作って

前回と同じ署名が返るはずですが、応答が 署名だけになり、「以下のとおりです」などの前置きや、「ご確認ください」といった後書きが消えているのが確認できます。

次に、情報が不足している質問を送ります。

田中太郎のメール署名を作って

以下のような、不足項目だけを箇条書きで確認する応答が返れば、システムプロンプトの手順4が効いています。

以下の情報が不足しています。
- 部署名
- 役職
- メールアドレス

以上のように、エージェントに毎回一定の振る舞いをしてほしい(前置き・後書きを抑える/情報不足時の応答を型にはめる/出力フォーマットを固定する、など)ケースでは、システムプロンプトを 番号付きの手順書 として書き下すのが有効です。「丁寧に対応してください」のような曖昧な指示よりも、モデルが取るべきステップを具体的に列挙するほうが、応答の再現性が上がります。