Skip to main content
Ferramentas de servidor são executadas pelo Phaseo durante uma solicitação ao modelo. O modelo decide quando chamá-las; o Phaseo as executa no servidor e devolve o resultado ao ciclo do modelo. Use ferramentas de servidor quando o modelo precisar da hora atual, de contexto da Web, do texto de uma página ou da orientação de outro modelo, sem criar seu próprio executor de ferramentas.
As ferramentas de servidor estão em beta. Os formatos das solicitações e os dados retornados podem mudar conforme evolui o suporte dos provedores.

Ferramentas disponíveis

Como funcionam as ferramentas de servidor

  1. Adicione uma ou mais ferramentas de servidor ao array tools.
  2. O modelo decide se precisa de uma ferramenta e emite uma chamada de ferramenta.
  3. O Phaseo intercepta a chamada da ferramenta de servidor, executa-a e envia o resultado de volta ao modelo.
  4. O modelo continua e redige a resposta final.
As ferramentas de servidor podem ser usadas com suas próprias ferramentas de função. O Phaseo executa apenas as ferramentas de servidor; sua aplicação continua tratando as chamadas function comuns.

Início rápido

Combinação com ferramentas de função

Se o modelo chamar phaseo:web_search, o Phaseo executará essa chamada automaticamente. Se chamar save_research_item, sua aplicação receberá a chamada da função e deverá retornar o resultado em uma solicitação seguinte.

Endpoints compatíveis

As ferramentas de servidor são compatíveis com:
  • /v1/chat/completions
  • /v1/responses
  • /v1/messages
Solicitações em streaming são compatíveis. Para ferramentas de servidor gerenciadas pelo gateway, o Phaseo pode materializar o turno de chamada da ferramenta upstream, executá-la, continuar o ciclo e emitir um stream sintético com a resposta final.

Acompanhamento de uso

O uso das ferramentas de servidor é informado em usage.server_tool_use:
A precificação também pode usar medidores de ferramentas de servidor como server_tool_web_search_requests, server_tool_web_search_extra_results, server_tool_web_fetch_requests, server_tool_advisor_requests, server_tool_image_generation_requests, native_web_search_requests e native_web_fetch_requests quando configurados nos cartões de preços dos modelos.

Páginas de ferramentas

Data e hora

Forneça ao modelo a data e a hora atuais.

Busca na Web

Permita que o modelo pesquise na Web quando precisar de informações atuais.

Busca de páginas da Web

Permita que o modelo busque e leia URLs específicas.

Advisor

Permita que um modelo consulte outro durante a geração.

Subagente

Permita que o modelo delegue tarefas específicas a um modelo auxiliar.

Fusão

Execute análises paralelas com vários modelos e sintetize os resultados.

Buscar modelos

Permita que o modelo procure um modelo adequado no catálogo atualizado do Phaseo.

Geração de imagens

Permita que o modelo crie imagens enquanto responde.

Aplicar patch

Gere um patch validado para criar, atualizar ou excluir arquivos.
Última modificação em 2 de outubro de 2026