Curso
Working with the OpenAI API
3 h
58.3K
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 anthropicDepois 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:
Quais são as principais diferenças entre a API de conclusão de texto herdada e a API de mensagens mais recente na API do Anthropic?
Posso usar o Artifacts diretamente por meio da API Sonnet do Claude 3.5?
Tópicos
