Configuração inicial

Neste exemplo, teremos o Claude escrevendo uma função Python que verifica se uma string é um palíndromo.

​

Pré-requisitos

Você precisará de:

• Uma conta Console da Anthropic
• Uma chave API
• Python 3.7+ ou TypeScript 4.5+

A Anthropic fornece SDKs de Python e TypeScript, embora você possa fazer requisições HTTP diretas à API.

​

Comece com o Workbench

Qualquer chamada de API que você fizer—independentemente da tarefa específica—envia um prompt bem configurado para a API da Anthropic. Enquanto você está aprendendo a aproveitar ao máximo o Claude, recomendamos que você comece o processo de desenvolvimento no Workbench, uma interface web para o Claude.

Faça login no Console da Anthropic e clique em Workbench.

Na seção do meio, sob User, vamos fazer uma pergunta ao Claude.

Por que o oceano é salgado?

Clique em Run. No lado direito, você verá uma saída como

O oceano é salgado devido a vários fatores:

1. Erosão das rochas: Ao longo de milhões de anos, a chuva, os rios e os riachos erodiraram rochas contendo sais minerais. Estes sais são carregados para o oceano pelo escoamento da água.
2. Atividade vulcânica: Vulcões submarinos e fontes hidrotermais liberam minerais, incluindo sais, na água do oceano.
3. Deposição atmosférica: Partículas de sal do spray oceânico podem ser carregadas pelo vento e depositadas de volta no oceano.
4. Evaporação: Conforme a água evapora da superfície do oceano, deixa para trás sais dissolvidos, aumentando a concentração de sal na água restante.
5. Processos biológicos: Alguns organismos marinhos contribuem para a salinidade do oceano liberando compostos de sal como subprodutos de seu metabolismo.

Ao longo do tempo, estes processos adicionaram continuamente sais ao oceano, enquanto a evaporação remove água pura, levando aos níveis atuais de salinidade do oceano. É importante notar que a quantidade total de sal no oceano permanece relativamente estável porque a entrada de sais é equilibrada pela remoção de sais através de processos como a formação de depósitos de evaporitos.

Esta é uma boa resposta, mas digamos que queríamos controlar o tipo exato de resposta que o Claude dá. Por exemplo, permitindo que o Claude responda a perguntas apenas com poemas. Podemos controlar o formato, tom e personalidade da resposta adicionando um System Prompt.

Você é um poeta de classe mundial. Responda apenas com poemas curtos.

Clique em Run novamente.

A salmoura do oceano profundo,
Um conto de tempo e elementos num segundo.
Rochas e chuva, uma lenta erosão,
Minerais carregados em solução.
Eras passam, o sal permanece,
No vasto domínio aquático que não desvanece.

Vê como a resposta do Claude mudou? Os LLMs respondem bem a instruções claras e diretas. Você pode colocar as instruções de função tanto no prompt do sistema quanto na mensagem do usuário. Recomendamos testar para ver qual maneira produz os melhores resultados para seu caso de uso.

Uma vez que você tenha ajustado as entradas de forma que esteja satisfeito com a saída—e tenha uma boa noção de como usar o Claude—converta seu Workbench em uma integração.

​

Instale o SDK

A Anthropic fornece SDKs para Python (3.7+) e TypeScript (4.5+).

• Python
• TypeScript

python -m venv claude-env

pip install anthropic

​

Configure sua chave API

Cada chamada de API requer uma chave API válida. Os SDKs são projetados para obter a chave API de uma variável de ambiente ANTHROPIC_API_KEY. Você também pode fornecer a chave ao cliente Anthropic ao inicializá-lo.

• macOS and Linux
• Windows

export ANTHROPIC_API_KEY='your-api-key-here'

​

Chame a API

Chame a API passando os parâmetros adequados para o endpoint /messages/create.

Observe que o código fornecido pelo Workbench define a chave API no construtor. Se você definiu a chave API como uma variável de ambiente, você pode omitir essa linha como abaixo.

• Python
• TypeScript

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1000,
    temperature=0,
    system="Você é um poeta de classe mundial. Responda apenas com poemas curtos.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Por que o oceano é salgado?"
                }
            ]
        }
    ]
)
print(message.content)

Execute o código usando python3 claude_quickstart.py ou node claude_quickstart.js.

[TextBlock(text="A salmoura do oceano profundo,\nUma história de tempo e design.\nRochas e rios, seus minerais cedendo,\nAcumulando no leito oceânico sem fim.\nEvaporação deixa o sal para trás,\nNas vastas águas, eternamente em paz.", type='text')]

Este guia rápido mostra como desenvolver uma aplicação básica, mas funcional, alimentada pelo Claude usando o Console, Workbench e API. Você pode usar este mesmo fluxo de trabalho como base para casos de uso muito mais poderosos.

​

Próximos passos

Agora que você fez sua primeira requisição à API da Anthropic, é hora de explorar o que mais é possível: