Integrando com os sistemas da empresa: a API local do Ollama

A API é um balcão

API é o balcão de atendimento de um programa. Outro programa chega, faz um pedido em formato combinado e recebe a resposta. Sem tela, sem clique. É assim que o seu sistema de pedidos ou de atendimento pode usar a IA.

O Ollama já tem esse balcão aberto, no mesmo endereço que você viu: http://localhost:11434.

A primeira chamada

Abra o terminal e cole este comando:

Volta um texto com a resposta dentro do campo "response". Se aparecer, funcionou. O "stream": false pede a resposta inteira de uma vez, em vez de palavra por palavra.

Três integrações simples

Imagine uma oficina que liga o sistema de orçamentos à IA. O atendente escreve o defeito do jeito que o cliente falou, e a IA devolve uma ordem de serviço estruturada. A pessoa revisa e aprova.

Regra de ouro

A IA propõe, a pessoa decide. Em qualquer integração, deixe um humano revisar o que vai para fora ou mexe em dinheiro. E guarde o registro de cada chamada.

Peça respostas previsíveis

Um sistema não gosta de surpresa. Se você espera uma categoria, peça: "responda só com uma destas palavras". Se espera dados, peça uma lista com campos fixos. Quanto mais fechado o pedido, mais fácil de ligar ao resto do sistema. E trate o erro: se a IA responder algo fora do combinado, o sistema deve devolver o caso a uma pessoa em vez de seguir adiante.

Onde a integração pode falhar

Três lugares. O Ollama pode estar desligado ou ocupado, então o sistema precisa esperar e tentar de novo. O modelo pode demorar, e o sistema deve ter um limite de tempo. E o texto que entra pode ser enorme, maior que a janela de contexto do modelo. Em todos os casos, o plano é o mesmo: avisar uma pessoa, nunca falhar em silêncio. Registre também o tempo de cada resposta. Se ele começar a subir semana após semana, é sinal de que a máquina está ficando pequena para o uso.

Antes de ligar tudo

Comece por um processo só, de baixo risco, e rode em paralelo com o trabalho manual por uma semana. Compare. Só então deixe a integração trabalhar sozinha. Um erro numa integração se repete centenas de vezes antes de alguém notar, e por isso o teste vem antes.

Quem cuida da integração

Anote quem criou, quem mantém e como desligar. Se a IA começar a dar respostas estranhas, precisa existir um botão de emergência: uma chave que volta o processo ao modo manual em um minuto. Quem constrói a integração costuma esquecer essa parte, e é a que mais salva no dia ruim.