improve javadocs

Author: rpanackal

foundation-models/openai/src/main/java/com/sap/ai/sdk/foundationmodels/openai/OpenAiMessage.java

@@ -61,6 +61,7 @@ static OpenAiSystemMessage system(@Nonnull final String message) {
    * A convenience method to create a tool message.
    *
    * @param message the message content.
+   * @param toolCallId identifier of the tool call this message is responding to.
    * @return the tool message.
    */
   @Nonnull

foundation-models/openai/src/main/java/com/sap/ai/sdk/foundationmodels/openai/OpenAiToolMessage.java

@@ -32,9 +32,10 @@ public class OpenAiToolMessage implements OpenAiMessage {
   @Nonnull private final String toolCallId;
 
   /**
-   * Creates a new tool message from a string.
+   * Creates a new tool message from a string and tool call id.
    *
    * @param message the first message.
+   * @param toolCallId identifier of the tool call this message is responding to.
    */
   OpenAiToolMessage(@Nonnull final String message, @Nonnull final String toolCallId) {
     this(new OpenAiMessageContent(List.of(new OpenAiTextItem(message))), toolCallId);