Configurando para Introdução a Agentes de IA

Criar um agente requer uma quantidade surpreendentemente pequena de configuração. Você precisa de um lugar para enviar uma requisição, permissão para enviá-la, e um modelo do outro lado que possa chamar ferramentas.

São três valores. O resto deste guia é sobre acertá-los da primeira vez, para que nada no curso falhe por um motivo que não tenha a ver com agentes.

Estas páginas acompanham o curso Introdução a Agentes de IA da Scrimba, e funcionam por conta própria. Se você está trabalhando no curso no navegador, você só precisa das três primeiras páginas. Se preferir ter o código na sua própria máquina, a última página também cobre isso.

O código do curso é JavaScript, e o manual de JavaScript está lá se você quiser revisar isso primeiro.

O que você vai configurar

Três variáveis de ambiente carregam tudo o que o código do curso precisa para chegar a um modelo:

Variável	O que ela contém
AI_URL	A URL base da API do provedor, que é para onde as requisições são enviadas
AI_KEY	Sua chave de API, que é o que autoriza essas requisições
AI_MODEL	O ID do modelo específico com o qual você quer conversar

Elas precisam estar de acordo uma com a outra. Uma chave válida apontada para a URL do provedor errado falha, e um provedor correto com um ID de modelo que o provedor não serve também falha. Sempre que você mudar de provedor, mude todos os três juntos.

Vindo de Introdução a Engenharia de IA?

Estas são as mesmas três variáveis que aquele curso usava. Se você já as tem salvas no Scrimba, você pode pular direto para modelos recomendados e confirmar que seu modelo suporta chamada de ferramentas.

JunoO que você vai configurarAI_URL, AI_KEY e AI_MODEL são uma configuração em três partes. A URL diz com qual empresa você está falando, a chave prova que você tem permissão, e o modelo diz qual cérebro responde.

Eles só funcionam como um conjunto combinado, então mude todos os três juntos sempre que você mudar de provedor. Misturar a chave de um provedor com a URL de outro é o erro que quase todo mundo comete uma vez!

JunoO que você vai configurar Esses três formam um conjunto combinado, e a falha que você realmente vai encontrar não é um erro de digitação em um deles. É uma sobra: uma chave do provedor que você usou mês passado enviada para a URL que você configurou hoje.

Então trate a mudança de provedores como uma edição com três partes. Se você receber um erro de autenticação ou um erro de modelo não encontrado, releia todos os três antes de reler qualquer um do seu próprio código.

JunoO que você vai configurar A razão de uma incompatibilidade merecer esta atenção toda é que as mensagens de erro mentem sobre onde o problema está. Uma chave enviada para a URL base errada volta como um 401, que se lê como "sua chave é ruim" quando a chave está ótima. Um modelo que seu provedor não serve volta como um 404 no nome do modelo, que se lê como um erro de digitação.

Ambos são o mesmo defeito subjacente, e nenhuma mensagem aponta para ele. Manter os três valores juntos em sua cabeça como uma unidade é o que o salva de meia hora.

As páginas em ordem

Configuração do provedor orienta na criação de uma conta com OpenAI ou OpenRouter, geração de uma chave de API, e armazenamento de todos os três valores.

Modelos recomendados cobre o único requisito difícil, chamada de ferramentas, e fornece uma lista testada e reduzida para você não ter que adivinhar.

Chat Completions e Responses explica as duas APIs OpenAI que você verá na prática, como suas formas de requisição e resposta diferem, e por que este curso usa Responses.

Executando o código localmente é para quando você quer tirar o projeto do Scrimba e colocá-lo na sua própria máquina, cobrindo o download, o arquivo .env, instalação de dependências, e as colisões de porta que pegam as pessoas desprevenidas.

Uma coisa a decidir de antemão

Quase tudo neste curso funciona com qualquer provedor que fale o formato da API OpenAI. O que não varia é o requisito de que seu modelo possa chamar ferramentas.

Um agente é um modelo que decide usar uma ferramenta, então um modelo sem chamada de ferramentas não pode ser transformado em um, não importa como o resto do código seja escrito. Tenha isso em mente se você explorar além da lista recomendada, porque uma limitação de modelo e um bug no seu código parecem idênticos no console.

JunoUma coisa a decidir de antemão Chamada de ferramentas é a única coisa que um modelo precisa ser capaz de fazer aqui. Todo o resto é preferência: quão rápido é, quanto custa, quão conversador é.

Um agente é um modelo que pede ao seu código para executar algo, então um modelo que não pode fazer essa solicitação não pode ser um agente. A lista reduzida na página de modelos já tem isso verificado, então você não precisa trabalhar isso por conta própria.

JunoUma coisa a decidir de antemão Chamada de ferramentas é o requisito difícil, e é a primeira coisa a verificar quando você sai da lista recomendada. As fichas de modelo a declaram, geralmente como "function calling" ou "tools".

Construa o hábito agora: quando uma lição se comporta mal e seu código combina com a solução, troque por um modelo comprovado antes de reler seu próprio trabalho. É um teste de trinta segundos que descarta a causa que as pessoas verificam por último.

JunoUma coisa a decidir de antemão Chamada de ferramentas é uma capacidade do endpoint servido, não apenas do modelo, que é a parte que pega as pessoas. Os mesmos pesos atrás de uma rota diferente podem voltar sem suporte a ferramentas, e um nível gratuito pode servir uma variante quantizada ou de outra forma reduzida sem o recurso.

É por isso que a lista reduzida nomeia rotas e não apenas famílias de modelos. Quando um modelo que deveria suportar ferramentas parece não suportar, verifique qual rota você realmente está acessando antes de concluir que o modelo é o culpado.

Outros cursos de IA da Scrimba

Todo outro curso e projeto de IA tem seu próprio guia de configuração local. Execute um projeto de curso de IA localmente é o índice para esses, cobrindo o AI Engineer Path, Chef Claude e Introdução a Mistral AI.

Faça o AI Engineer Path no ScrimbaO AI Engineer Path da Scrimba leva você de sua primeira chamada de LLM a agentes, RAG e MCP em nove módulos interativos.→