Ask
O endpoint /support/ask é um agente de suporte com IA que diagnostica problemas nos seus jobs do Firecrawl, na sua conta e no uso da API. Envie uma pergunta e receba uma resposta verificada com parâmetros práticos para correção — normalmente em 15–30 segundos.
/support/ask foi criado para comunicação de agente para agente. Se você estiver criando um agente de IA que usa o Firecrawl, conecte esse endpoint ao seu fluxo de tratamento de erros para que seu agente possa diagnosticar por conta própria falhas de scraping, problemas de rastreamento e problemas de configuração sem intervenção humana.
Passe um campo rationale para dar contexto ao agente de suporte sobre o que seu usuário final está tentando fazer. Isso ajuda a priorizar a coleta de evidências.
- Você descreve o problema — uma pergunta em linguagem natural que descreve o problema.
- O agente investiga — ele inspeciona logs de job, o estado da conta, a documentação e o código-fonte.
- O agente valida — quando possível, o agente testa uma correção na API Firecrawl em produção (por exemplo, repetindo um scraping com parâmetros ajustados).
- Você recebe uma resposta verificada — a resposta inclui um
answerem texto explicativo,fixParameterslegíveis por máquina que você pode aplicar diretamente e resultados devalidationmostrando se a correção foi testada.
Usa sua chave de API do Firecrawl como token Bearer. A solicitação é automaticamente restrita à sua equipe — você só pode consultar seus próprios jobs e os dados da sua conta.
curl -X POST https://api.firecrawl.dev/v2/support/ask \
-H "Authorization: Bearer fc-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"question": "my crawl returned 3 pages but I expected 50",
"rationale": "user is on their third failed crawl attempt today"
}'| Campo | Tipo | Descrição | |
|---|---|---|---|
answer | string | Texto em prosa de 2 a 4 frases com o diagnóstico e a correção | |
confidence | string | high, medium ou low | |
fixParameters | object | null | Parâmetros da API para aplicar a correção (por exemplo, {"waitFor": 5000}) |
validation | object | null | Indica se a correção foi testada: tested, result (success/failure/skipped), evidence |
feedback | object | null | Presente quando o agente fica bloqueado; { blockedBy, attempted }. Nulo em caso de sucesso. |
durationMs | integer | Tempo total de execução em milissegundos |
| Código | Significado |
|---|---|
200 | Respondido ou travado (o envelope é sempre retornado) |
400 | JSON inválido ou violação de esquema |
401 | Token Bearer ausente ou inválido |
504 | Atingiu o limite rígido de 60 s — envelope parcial retornado |
Para ver o guia da funcionalidade com exemplos de integração, consulte a documentação da funcionalidade Ask.
Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para instruções de onboarding automatizado.