Tutorial da API do Claude Sonnet 3.5: Primeiros passos com a API do Anthropic

A Anthropic lançou recentemente o Claude 3.5 Sonnet, um modelo avançado que superou o GPT-4o e o Gemini Pro 1.5 em vários benchmarks.

Os recursos de raciocínio visual do Claude 3.5 Sonnet são especialmente impressionantes, e você pode querer usá-los em seu fluxo de trabalho de desenvolvimento por meio da API do Claude 3.5 Sonnet.

Neste artigo, ajudarei você a começar a usar a API do Claude 3.5 Sonnet e fornecerei um guia passo a passo para usar o Claude 3.5 Sonnet por meio da API do Anthropic.

Se você quiser ter uma visão geral do Claude 3.5 Sonnet, recomendo este artigo sobre O que é o Claude 3.5 Sonnet.

O que é o soneto de Claude 3.5?

Claude 3.5 O Sonnet é um modelo de linguagem grande desenvolvido pela Anthropic. Ele faz parte da grande família Claude 3.5 - a Anthropic lançará o Claude 3.5 Opus e o Claude 3.5 Haiku ainda este ano.

O Claude 3.5 Sonnet demonstra melhorias notáveis na compreensão e na geração de imagens e tem apresentado um bom desempenho em benchmarks, especialmente em tarefas de codificação e raciocínio, em comparação com outros modelos como GPT-4o, Gemini 1.5 Pro ou Llama-400b.

Além disso, ele apresenta um novo recurso chamado Artifacts para aprimorar o gerenciamento de informações nas conversas. Você pode saber mais sobre artefatos neste artigo introdutório sobre Claude Sonnet 3.5.

Claude 3.5 API do Sonnet: Como se conectar à API da Antrophic

Para começar a usar a API Sonnet do Claude 3.5, você precisa se inscrever em uma conta da API Anthropic e configurar o cliente Anthropic. Vamos ver isso passo a passo.

Obtenção de acesso à API

Etapa 1: Registre-se

Visite o Console antrópico e crie uma conta. Você precisará fornecer informações básicas e verificar seu e-mail.

Etapa 2: Chave da API

Quando sua conta estiver configurada, navegue até Obter chaves de API e clique em Criar chave para gerar sua chave de API.

Configurando seu ambiente

Para inicializar o cliente do Anthropic, você precisa primeiro instalar a biblioteca anthropic da seguinte forma:

pip install anthropic

Depois de instalar a biblioteca, você pode inicializar o cliente do Anthropic usando sua chave de API.

import anthropic
# Create an instance of the Anthropics API client
client = anthropic.Anthropic(api_key='your_api_key_here')  

Com a biblioteca anthropic instalada e o cliente Anthropic inicializado com sua API, vamos começar a explorar os recursos do Claude 3.5 Sonnet.

API do Claude: API de mensagens vs. API de conclusão de texto

Claude 3.5 A API do Sonnet oferece recursos avançados, especialmente a API Messages, que foi projetada para criar interações ricas e dinâmicas.

Observe que a API de conclusão de texto agora é considerada legada. Embora ofereça recursos básicos de preenchimento, não possui os recursos avançados e a flexibilidade da API Messages.

Os usuários são incentivados a migrar para a API Messages para obter funcionalidade aprimorada e suporte futuro.

Além disso, atualmente, os artefatos não podem ser acessados por meio da API. Para interagir com o Artifacts, você precisa usar a interface da Web fornecida pelo Claude.aique oferece suporte total à edição, à referência e ao download de conteúdo gerado pelo Claude 3.5 Sonnet.

Claude 3.5 API do Sonnet: API de mensagens

A API Messages permite que você envie uma lista estruturada de mensagens de entrada com conteúdo de texto ou imagem, permitindo que o modelo gere a próxima mensagem na conversa.

Essa API é compatível com consultas únicas e conversas sem estado com várias voltas.

Para criar uma mensagem, você pode usar a biblioteca Python anthropic e chamar o método messages.create com os parâmetros necessários. Os principais parâmetros incluem o modelo, as mensagens e várias configurações opcionais para controlar a saída.

Parâmetros necessários

Vamos explorar os parâmetros necessários:

• model: O modelo a ser usado (por exemplo, "claude-3-5-sonnet-20240620").

• messages: Uma lista de mensagens de entrada. Cada mensagem deve ter uma função ("usuário" ou "assistente") e um conteúdo.

Até a data em que este artigo foi escrito, esses são os modelos disponíveis na API do Anthropic:

Parâmetros opcionais

Os parâmetros opcionais incluem:

• max_tokens: O número máximo de tokens a serem gerados.
• temperature: Controla a aleatoriedade da resposta.
• stop_sequences: Sequências de texto personalizadas que fazem com que o modelo pare de gerar.
• stream: Se você deseja transmitir a resposta de forma incremental.
• system: Um prompt do sistema que fornece contexto e instruções.
• tools: Definições de ferramentas que o modelo pode usar.
• top_k: Faça uma amostragem apenas das K opções principais para cada token subsequente. Usado para remover respostas de baixa probabilidade de "cauda longa".
• top_p: Use a amostragem de núcleo para cortar as opções menos prováveis com base na probabilidade cumulativa de atingir um limite especificado.

Claude 3.5 API do Sonnet: Casos de uso

Agora que entendemos todos os parâmetros envolvidos, vamos explorar os casos de uso prático da API Messages usando Python e a biblioteca anthropic:

Solicitação de mensagem única

É assim que podemos fazer uma solicitação de mensagem única:

response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, world"}]
)

Conversa com várias voltas

Vamos agora iniciar uma conversa com várias voltas:

response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=512,
    messages=[
        {"role": "user", "content": "Hello there."},
        {"role": "assistant", "content": "Hi, I'm Claude. How can I help you?"},
        {"role": "user", "content": "Can you explain LLMs in plain English?"}
    ]
)

Inclusão de conteúdo de imagem

A partir dos modelos Claude 3, você pode incluir conteúdo de imagem em suas mensagens.

response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=512,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": "image/jpeg",
                        "data": "media_file"
                    }
                },
                {
                    "type": "text",
                    "text": "What is in this image?"
                }
            ]
        }
    ]
)

Usar os prompts do sistema e as sequências de parada

É assim que podemos usar os avisos do sistema e as sequências de parada:

response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a short story."}],
    system="You are a creative writing assistant.",
    stop_sequences=["The end."],
    temperature=0.9
)

Definições de ferramentas

Você pode definir ferramentas para o modelo usar durante as interações. Isso inclui a especificação do nome, da descrição e do esquema de entrada da ferramenta.

# Define the request parameters
model = "claude-3-5-sonnet-20240620"
messages = [{"role": "user", "content": "What's the S&P 500 at today?"}]
tools = [
    {
        "name": "get_stock_price",
        "description": "Get the current stock price for a given ticker symbol.",
        "input_schema": {
            "type": "object",
            "properties": {
                "ticker": {
                    "type": "string",
                    "description": "The stock ticker symbol, e.g., AAPL for Apple Inc."
                }
            },
            "required": ["ticker"]
        }
    }
]
# Create a message with the defined parameters
response = client.messages.create(
    model=model,
    messages=messages,
    tools=tools
)

Conclusão

Neste guia, exploramos como você pode se conectar à API do Anthropic para usar o modelo Sonnet do Claude 3.5. Abordamos os principais aspectos, como configuração, autenticação e uso da API Messages para várias tarefas.

Se você estiver criando um chatbot, um gerador de conteúdo ou qualquer outro aplicativo com tecnologia de IA, o Claude 3.5 Sonnet pode ser uma boa opção.

Para saber mais sobre o Claude Sonnet e como ele se compara ao ChatGPT, confira os artigos abaixo:

• O que é o soneto de Claude 3.5?
• Claude vs ChatGPT para ciência de dados