Conecte um provedor de IA

Sua conta, seus modelos

Uma conexão de provedor de IA guarda duas coisas: qual empresa responde e a sua chave de API nela. Ela não fixa um modelo — o modelo é escolhido em cada tela que conversa com a IA, então o assistente do editor pode usar um modelo rápido e barato enquanto o construtor de scrapers usa um mais forte, os dois na mesma chave.

1def main(name: str = "world", shout: bool = False):2    text = f"Hello, {name}!"3    return {"message": text}

A chave vira uma variável secreta como qualquer credencial de conexão: uma conexão chamada claude guarda a chave como AI_CLAUDE_API_KEY. Ela não pode ser lida depois de salva, apenas substituída.

Conecte um

1. 1
   Escolha Provedor de IA

   Em Integrações, clique em Adicionar integração e escolha Provedor de IA no grupo Serviços.

2. 2
   Escolha a empresa e cole a chave

   Dê um Nome (por exemplo claude), escolha o Provedor — cada linha diz Pegue uma chave em … — e cole a Chave de API.

3. 3
   Salve e teste

   Salvar conexão, confirme o nome da variável e abra a conexão de novo: o bloco Modelo lista os modelos que a sua conta pode rodar, com o padrão marcado como Padrao. Testar conexão envia uma requisição mínima para conferir a chave — custa praticamente nada na sua conta.

O que usa a conexão

• O assistente do editor — a aba lateral de chat de IA do editor de script, e o Fix with AI de uma execução com falha.
• O assistente de flow — o chat de IA da página do flow, que lê o seu flow e propõe mudanças que você revisa no canvas.
• O assistente de e-mail no estúdio de templates da página E-mail.
• O construtor do AI Scraper: ele planeja o scraper e escreve o programa com o seu modelo. Scrapers publicados depois rodam sem IA nenhuma.

Sem conexão esses lugares não quebram — eles avisam. A página de scrapers mostra Conecte um provedor de IA para usar os scrapers com Conectar um provedor, que abre o diálogo já em Provedor de IA; um pedido ao assistente responde needs_ai_provider.

O verificador

A lista de provedores também oferece o TypeSafe Jev, marcado como Verificador: um modelo de decisão que julga se a construção de um scraper respondeu ao pedido. Ele nunca planeja nem conversa, então nunca aparece no seletor de modelo, e um projeto tem no máximo um.

Escolha o modelo

Todo chat de IA tem um seletor de modelo mostrando provedor · modelo. Clique nele (Trocar o modelo), busque com Buscar modelos… e escolha; o modelo em uso fica fixo no topo em Em uso, e cada modelo traz uma faixa de custo aproximada — $ a mais barata, $$ intermediária, $$$ a mais cara. Com mais de uma conexão de IA no projeto, o seletor pede primeiro a Conexão e depois o Modelo.

A escolha fica salva para o projeto e para aquela tela — o assistente do editor, o assistente do flow, o assistente de e-mail e o chat do scraper guardam cada um a sua — então o seu time compartilha a escolha. Enquanto não há escolha, um projeto com uma conexão só usa o modelo padrão dela.

Custos e limites

• Toda chamada de IA é cobrada pelo provedor na conta cuja chave você salvou — não pelo Waiso, e não em créditos.
• Se a lista de modelos da conta não puder ser lida, o seletor oferece só o padrão: “Nao foi possivel ler a lista de modelos desta conta, entao so o padrao e oferecido.”
• Seus scripts não conseguem chamar o provedor de IA sozinhos: o código do usuário roda sem acesso à rede. Use os assistentes enquanto constrói.