Request for Feedback

[aaron-lerner]

👋 Hi everyone!

This SDK is in alpha, and we are actively iterating on its design and making improvements. We would love to hear your thoughts and feedback!

As you try the new SDK, please share your thoughts and feedback. We'll be actively monitoring discussion threads and new issues.

Thanks in advance! We hope to make a Java SDK you'll love using.

[sgflt]

#30 (comment)

Thank you for exmaples. I've been able to find method visit, that I have overlooked. It would be nice to provide example for tool usage :).

I have produced some looping code that fullfils my flow:

• Grab data and tools and throw them at Claude
• Invoke tools if Claude wants and send back results
• Return final JSON response for further automatic processing

Details

public String askClaude(final String system, final String body) {
    final var messageBuilder = createConversation(system, body);
    var response = this.client.messages().create(messageBuilder.build());
    boolean doLoop = true;
    while (doLoop) {
      final var previousResponse = response;
      messageBuilder.addMessage(previousResponse);

      final var newResponse = response.content().stream()
          .map(content -> content.accept(new ContentBlock.Visitor<Message>() {

            @Override
            public Message visitTextBlock(@NotNull final TextBlock textBlock) {
              return null; // end of looping
            }


            @Override
            public Message visitToolUseBlock(@NotNull final ToolUseBlock toolUseBlock) {
              messageBuilder.addMessage(
                  MessageParam.builder()
                      .role(MessageParam.Role.USER)
                      .content(
                          MessageParam.Content.ofContentBlockParams(
                              List.of(
                                  ContentBlockParam.ofToolResultBlockParam(
                                      ToolResultBlockParam.builder()
                                          .type(ToolResultBlockParam.Type.TOOL_RESULT)
                                          .toolUseId(toolUseBlock.id())
                                          .content(executeToolUse(toolUseBlock))
                                          .build()
                                  )
                              )
                          )
                      )
                      .build()
              );
              return SyncRequestClient.this.client.messages().create(messageBuilder.build());
            }
          }))
          .filter(Objects::nonNull)
          .findFirst()
          .orElse(null);

      // kind of heuristic ending
      doLoop = newResponse != null;
      if (newResponse != null) {
        response = newResponse;
      }
    }

    return response.content()
        .stream()
        .flatMap(contentBlock -> contentBlock.textBlock().stream())
        .map(TextBlock::text)
        .collect(Collectors.joining());
  }

[wwang-talend]

Hi team, thanks for the good examples. Do we have a api to support big request body set/big body response? Or is not necessary in fact? like this case :
https://docs.anthropic.com/en/prompt-library/corporate-clairvoyant
I check the api, not find the way to support set inputstream and return outputstream thing.

MessageCreateParams createParams = MessageCreateParams.builder()
                .model(Model.CLAUDE_3_5_SONNET_LATEST)
                .maxTokens(2048)
                .addUserMessage("Tell me a story about building the best SDK!")
                .build();

MessageCreateParams createParams = MessageCreateParams.builder()
                .putAdditionalHeader("anthropic-version", "2023-06-01").putAllAdditionalBodyProperties(null).build();
Map response = client.messages().create(createParams).validate()._additionalProperties();

[TomerAberbach]

I don't think the API supports streaming text to the API. However, you can stream the output from the API

See this streaming example: https://github.com/anthropics/anthropic-sdk-java/blob/main/anthropic-java-example/src/main/java/com/anthropic/example/MessagesStreamingExample.java

Does this answer your question?

[wwang-talend]

Thanks @TomerAberbach , yes, it answer my question.

[stantonk]

This API is, frankly, insane. It looks like it was AI generated and is excessively, and confusingly verbose. There's no documentation. There are no complete examples. There's a ton of confusingly and similarly named classes. This is really how we have to return a tool call result?

 MessageCreateParams.Builder builder = MessageCreateParams.builder()
                .maxTokens(1024L);

        BetaToolResultBlockParam.Builder toolResultBuilder = BetaToolResultBlockParam.builder();
        toolResultBuilder.content("tool result");
        toolResultBuilder.isError(false);
        BetaToolResultBlockParam toolResult = toolResultBuilder.build();
        BetaContentBlockParam toolContentBlockParam = BetaContentBlockParam.ofToolResult(toolResult);
        BetaMessageParam messageParam = BetaMessageParam.builder().contentOfBetaContentBlockParams(List.of(toolContentBlockParam)).build();

        builder.addMessage(
                messageParam
        );

... and so on.

[stantonk]

Whats the difference between BetaMessageParam and BetaMessage? It seems like the former is for requests and the latter for responses, but then why do both have builders exposed to clients of the API? Why does MessageCreateParams.builder()'s .messages(...) method take a list of BetaMessageParam, but also has a .addMessage(...) method that takes a BetaMessage? When do we use one or the other?