---
title: "smolagents OpenAIModel com api_base personalizado | BroadRouter"
description: "Conecte o smolagents da Hugging Face à BroadNet Inference com OpenAIModel e api_base: CodeAgent em qualquer modelo, ToolCallingAgent no GLM 5.3 e no Qwen3.8 27B."
url: https://broadrouter.com/pt/guides/smolagents-openai-compatible/
lang: pt-BR
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/guides/smolagents-openai-compatible/) (atualizado em 2026-11-16).

# Rodar o smolagents na BroadNet Inference com OpenAIModel

Atualizado em 2026-11-16

Crie o OpenAIModel do smolagents com model\_id definido como um ID da BroadNet, por exemplo broadnet/glm-5.3, api\_base como https://inference.broadnet.ai/v1 e api\_key com a sua chave da BroadNet, e passe-o ao CodeAgent ou ao ToolCallingAgent. O CodeAgent escreve Python em vez de usar tool calls nativas, então roda no DeepSeek V4.1 Flash. O ToolCallingAgent exige GLM 5.3 ou Qwen3.8 27B.

O smolagents é a pequena biblioteca Python da Hugging Face para agentes. A classe `OpenAIModel` dele “connects to an OpenAI-compatible API server” (tradução: conecta-se a um servidor de API compatível com a OpenAI), com `api_base` para a URL. A BroadNet Inference oferece chat completions em `https://inference.broadnet.ai/v1`, então funciona diretamente. O BroadRouter é o site da própria BroadNet; este guia segue a documentação do smolagents 1.26.0.

## Instalação

```bash
pip install smolagents
export BROADNET_API_KEY='your-broadnet-key'
```

## CodeAgent

```python
import os
from smolagents import OpenAIModel, CodeAgent

model = OpenAIModel(
    model_id="broadnet/deepseek-v4.1-flash",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)

agent = CodeAgent(tools=[], model=model)
print(agent.run("What is 6 * 7? Use Python to check."))
```

O `CodeAgent` pede ao modelo que escreva Python entre tags `<code>` e executa esse código localmente. A requisição é uma chat completion comum, com stop sequences como `</code>` e sem o campo `tools`. Ou seja, ele não depende de tool calling nativo e pode rodar no `broadnet/deepseek-v4.1-flash`, o modelo dos [planos ilimitados](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) da BroadNet. A qualidade do código ainda varia de modelo para modelo, então teste as suas próprias tarefas.

O CodeAgent executa código escrito pelo modelo. Leia as orientações do smolagents sobre execução segura de código antes de dar a ele ferramentas que mexem em arquivos, rede ou credenciais.

## ToolCallingAgent

```python
from smolagents import ToolCallingAgent, tool

@tool
def get_weather(city: str) -> str:
    """Get the weather for a city.

    Args:
        city: The city name.
    """
    return f"21C in {city}"

model = OpenAIModel(
    model_id="broadnet/glm-5.3",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)
agent = ToolCallingAgent(tools=[get_weather], model=model)
print(agent.run("What's the weather in Riyadh?"))
```

O `ToolCallingAgent` envia as suas ferramentas, mais a ferramenta `final_answer` dele, como esquemas de função com `tool_choice: "required"`. Use `broadnet/glm-5.3` ou `broadnet/qwen3.8-27b`; a documentação da BroadNet lista ferramentas só para esses dois modelos.

## Qual modelo escolher

| Agente | Modelo |
| --- | --- |
| `CodeAgent`, execuções longas num plano de preço fixo | `broadnet/deepseek-v4.1-flash` |
| `ToolCallingAgent` | `broadnet/glm-5.3` |
| Qualquer um dos agentes com entrada de imagem | `broadnet/qwen3.8-27b` |

Uma sessão do plano roda uma requisição por vez, e um agente envia os passos um depois do outro, então uma sessão atende um agente. [Preços de todos os modelos](https://broadrouter.com/pt/pricing/).

## Como testamos

Em 2026-11-15 instalamos o smolagents 1.26.0 em um ambiente virtual limpo e rodamos os dois agentes contra um servidor mock local que fala o formato de chat completions da BroadNet. O `CodeAgent` com o ID do DeepSeek recebeu uma resposta com código, executou o código e devolveu 42. As requisições dele tinham `max_tokens: 4000`, stop sequences e nenhuma ferramenta. No `ToolCallingAgent`, conferimos o formato da requisição: o ID do modelo foi enviado sem alteração, com os dois esquemas de ferramenta e `tool_choice: "required"`. O smolagents devolve os resultados das ferramentas como mensagens de usuário. O nosso mock não seguia esse formato, então não levamos esse agente até a resposta final. Não tínhamos uma chave da BroadNet, então não testamos a saída real do modelo.

## Solução de problemas

-   **401.** A chave está errada, expirou ou ficou sem cota.
-   **404.** O `api_base` precisa terminar em `/v1`. Confira o ID do modelo. Os modelos pagos exigem uma recarga; o crédito de $5 cobre só `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe.
-   **“Make sure to provide correct code blobs”.** A resposta do modelo não tinha bloco de código. Aumente o `max_tokens`, porque o raciocínio conta nele, ou tente outro modelo. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **O ToolCallingAgent nunca termina.** Troque para `broadnet/glm-5.3` ou `broadnet/qwen3.8-27b`.
-   **429.** Uma chave de pagamento por uso permite 30 requisições por minuto. O smolagents pode se limitar sozinho com `requests_per_minute`. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).

## Termos neste guia

[Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/)

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

[Sequências de parada (stop sequences)](https://broadrouter.com/pt/glossary/stop-sequences/)

Sequências de parada são strings que você envia com a requisição e que fazem o modelo parar de gerar assim que produz uma delas. A OpenAI chama o campo de stop e aceita até 4 sequências; a Anthropic o chama de stop\_sequences. Normalmente o texto encontrado fica fora da saída retornada.

[API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/)

Uma API compatível com a OpenAI é uma API HTTP que aceita os mesmos formatos de requisição e de resposta da API da OpenAI, como POST /v1/chat/completions, de modo que SDKs e ferramentas da OpenAI podem usá-la trocando só a base URL, a chave de API e o nome do modelo.

[Chat Completions API](https://broadrouter.com/pt/glossary/chat-completions-api/)

A Chat Completions API é o endpoint HTTP da OpenAI, POST /v1/chat/completions, que recebe o nome de um modelo e uma lista de mensagens marcadas com papéis e devolve a próxima mensagem do modelo. O formato da requisição e da resposta virou o padrão comum que provedores e SDKs compatíveis com a OpenAI reutilizam.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

[Crédito pré-pago (prepaid credit)](https://broadrouter.com/pt/glossary/prepaid-credit/)

Crédito pré-pago é dinheiro adicionado a uma conta de API antes do uso. Cada requisição desconta o próprio custo do saldo e, quando o saldo acaba, as requisições cobradas por uso param até você fazer uma recarga. Ele limita o gasto ao que você já pagou.

[Plano de LLM com preço fixo (flat-rate)](https://broadrouter.com/pt/glossary/flat-rate-llm-plan/)

Um plano de LLM com preço fixo cobra um valor fixo por um período, como um mês, pelo acesso à API de um modelo de linguagem, em vez de cobrar por token. Esses planos costumam limitar outra coisa, como simultaneidade, velocidade, modelos ou janelas de uso, então os limites importam tanto quanto o preço.

## Perguntas frequentes

### Uso OpenAIModel ou OpenAIServerModel?

O smolagents 1.26 documenta o OpenAIModel para qualquer servidor compatível com a OpenAI. O pacote ainda exporta o OpenAIServerModel, mas a documentação descreve o OpenAIModel.

### O smolagents roda no plano ilimitado da BroadNet?

Os planos cobrem o DeepSeek V4.1 Flash. A BroadNet não lista tool calling para ele, mas o CodeAgent não precisa de tool calls nativas: ele pede código Python ao modelo. No nosso teste com servidor mock, um CodeAgent com o ID do DeepSeek enviou requisições de chat comuns, sem o campo tools.

### Por que o ToolCallingAgent exige GLM 5.3 ou Qwen3.8 27B?

Ele envia as ferramentas como esquemas de função da OpenAI com tool\_choice definido como required. A documentação da BroadNet lista ferramentas só para GLM 5.3 e Qwen3.8 27B.

### Como passo max\_tokens ou temperature?

Como argumentos nomeados do OpenAIModel. A documentação do smolagents diz que argumentos extras são repassados a cada chamada de completion. No nosso teste, max\_tokens=4000 foi enviado em todas as requisições.

## Guias relacionados

-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/)
-   [Como funcionam os planos de API de LLM ilimitada para agentes](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/)
-   [Todas as ferramentas que funcionam com a BroadNet Inference (em inglês)](https://broadrouter.com/integrations/): SDKs, agentes de programação, interfaces de chat e ferramentas de automação, com as configurações exatas de cada uma

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-smolagents-openai-compatible&utm_content=page-cta) ·

**Fontes**

-   [Documentação do smolagents v1.26.0, referência Models (OpenAIModel) (conferido em 2026-11-15)](https://huggingface.co/docs/smolagents/reference/models)
-   [PyPI, smolagents 1.26.0 (conferido em 2026-11-15)](https://pypi.org/project/smolagents/)
-   [Referência da API da BroadNet Inference (conferido em 2026-11-15) (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-smolagents-openai-compatible&utm_content=sources)
