Amazon Nova에서 도구 사용(함수 호출)

도구 호출 워크플로의 첫 번째 단계는 수학 수식 - 10회 5의 결과에 대한 Amazon Nova에 대한 사용자 쿼리입니다. 이 쿼리는 계산기를 나타내는 도구 사양과 함께 Amazon Nova에 프롬프트로 전송됩니다.

user_query = "10*5"

messages = [{
    "role": "user",
    "content": [{"text": user_query}]
}]

tool_config = {
    "tools": [
        {
            "toolSpec": {
                "name": "calculator", # Name of the tool
                "description": "A calculator tool that can execute a math equation", # Concise description of the tool
                "inputSchema": {
                    "json": { 
                        "type": "object",
                        "properties": {
                            "equation": { # The name of the parameter
                                "type": "string", # parameter type: string/int/etc
                                "description": "The full equation to evaluate" # Helpful description of the parameter
                            }
                        },
                        "required": [ # List of all required parameters
                            "equation"
                        ]
                    }
                }
            }
        }
    ]
}

Amazon Nova는 사용자 프롬프트와 함께 도구의 컨텍스트를 사용하여 사용할 필수 도구와 필요한 구성을 결정합니다. 이는 API 응답의 일부로 반환됩니다.

{
    "toolUse": {
        "toolUseId": "tooluse_u7XTryCSReawd9lXwljzHQ", 
        "name": "calculator", 
        "input": {
            "equation": "10*5"
         }
    }
}

애플리케이션은 도구를 실행하고 결과를 저장하는 역할을 합니다.

def calculator(equation: str):
    return eval(equation)
    
tool_result = calculator("10*5")

도구 결과를 Amazon Nova에 반환하기 위해 도구 결과가 새 API 요청에 포함됩니다. 도구 사용 ID는 이전 응답에서 Amazon Nova에서 반환된 ID와 일치합니다.

{ 
    "toolResult": {
        "toolUseId": "tooluse_u7XTryCSReawd9lXwljzHQ",
        "content": [
            {
                "json": {
                    "result": "50"
                }
            }
        ],
        "status": "success"
    }
}