cicora.ai
Especificação da APIFontes recentes

Pesquisa na Web

Recupere fontes recentes através de uma função `web_search` executada pelo cliente e mantenha as ligações separadas do texto gerado.

Referência de integração: escolha os parâmetros e as capacidades disponíveis nas definições da API da sua conta e no catálogo de modelos do seu ambiente.

Descrever a função do cliente

Envie `web_search` como uma ferramenta de função normal na matriz tools, tal como no exemplo. O modelo apenas pede a chamada; a sua aplicação executa a pesquisa através de uma fonte permitida.

Após a execução, devolva um resultado normalizado ao modelo numa mensagem com a função `tool` e o tool_call_id correspondente. O texto do modelo não substitui uma fonte: conserve o URL, o título, a data e o contexto.

Função de pesquisa Web executada pelo cliente
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "Find current primary sources for this topic."}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "web_search",
      "description": "Search permitted sources for current information.",
      "parameters": {
        "type": "object",
        "properties": {"query": {"type": "string"}},
        "required": ["query"],
        "additionalProperties": false
      }
    }
  }]
}

Resposta fiável

  • Valide o nome da função e o argumento da consulta antes de executar a pesquisa.
  • Mostre ao utilizador ligações junto das afirmações quando o fluxo de trabalho exigir verificação.
  • Restrinja domínios ou a tarefa no lado do produto quando a política da organização o exigir.

Custo e registo

Registe a despesa de pesquisa no executor da função separadamente dos tokens do modelo.

Não repita automaticamente a pesquisa após uma saída parcial: determine primeiro que fontes já chegaram e o que o utilizador viu.