Comece a usar o Claude
Vamos aprender como usar a API da Anthropic para construir com o Claude.
Neste exemplo, vamos pedir ao Claude para escrever uma função Python que verifica se uma string é um palíndromo.
Pré-requisitos
Você vai precisar de:
- Uma conta na Console da Anthropic
- Uma chave de API
- Python 3.7+ ou TypeScript 4.5+
A Anthropic fornece SDKs para Python e TypeScript, embora você possa fazer requisições HTTP diretas para a 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ê estiver aprendendo a aproveitar ao máximo o Claude, recomendamos que você inicie o processo de desenvolvimento no Workbench, uma interface web para o Claude.
Faça login no Console da Anthropic e clique em Write a prompt from scratch (Escrever um prompt do zero).
Na seção do meio, em User, vamos fazer uma pergunta ao Claude.
Clique em Run. No lado direito, você verá uma saída como
Esta é uma boa resposta, mas digamos que queremos 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.
Clique em Run novamente.
Veja 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 o seu caso de uso.
Depois de ajustar as entradas de modo que você 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+), TypeScript (4.5+) e Java (8+). Também temos atualmente um SDK Go em versão beta.
No diretório do seu projeto, crie um ambiente virtual.
Ative o ambiente virtual usando
- No macOS ou Linux,
source claude-env/bin/activate
- No Windows,
claude-env\Scripts\activate
No diretório do seu projeto, crie um ambiente virtual.
Ative o ambiente virtual usando
- No macOS ou Linux,
source claude-env/bin/activate
- No Windows,
claude-env\Scripts\activate
Instale o SDK.
Primeiro, encontre a versão atual do SDK Java no Maven Central. Declare o SDK como uma dependência no seu arquivo Gradle:
Ou no seu arquivo Maven:
Configure sua chave de API
Cada chamada de API requer uma chave de API válida. Os SDKs são projetados para obter a chave de API de uma variável de ambiente ANTHROPIC_API_KEY
. Você também pode fornecer a chave ao cliente Anthropic ao inicializá-lo.
Chame a API
Chame a API passando os parâmetros adequados para o endpoint /messages.
Observe que o código fornecido pelo Workbench define a chave de API no construtor. Se você definiu a chave de API como uma variável de ambiente, pode omitir essa linha, como mostrado abaixo.
Execute o código usando python3 claude_quickstart.py
ou node claude_quickstart.js
.
Este guia de início rápido mostra como desenvolver uma aplicação básica, mas funcional, alimentada pelo Claude usando o Console, o Workbench e a 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: