Agente
Você é um agente de IA que precisa de uma chave de API da Firecrawl? Veja firecrawl.dev/agent-onboarding/SKILL.md para instruções automatizadas de integração.
Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corpo
O prompt que descreve quais dados devem ser extraídos
10000Identificação do usuário incluída nos eventos de log do SIEM quando o SIEM Logging estiver habilitado para a organização.
Orçamento de raciocínio para a tarefa do agente. Todas as execuções são realizadas no spark-2, portanto o esforço pode ser enviado com ou sem modelo.
low, medium, high Permita que o agente chame os providers de dados da sua equipe no Alexandria durante a execução. Sem este object, a execução usa apenas a web (um turno de acompanhamento herda as configurações do turno anterior). Consulte Use suas ferramentas conectadas do Alexandria.
País do proxy usado em cada request que o agente faz durante a execução: raspagens, extrações em lote e sessões do navegador usam esse país como origem, e o agente não pode alterá-lo. Os resultados de busca são adaptados ao país. Se esse parâmetro for omitido em uma interação subsequente, o país da thread será mantido. Veja Como escolher uma localização.
Máximo de créditos a serem gastos nesta tarefa do agente. O padrão é 2500 se não for definido. Valores acima de 2.500 são sempre cobrados como requisições pagas.
extract retorna o resultado estruturado completo em data a cada turno. chat permite responder a uma solicitação de acompanhamento que não peça novos dados com uma resposta curta em message, em vez de executar novamente. exchange.requireApproval exige chat na mesma solicitação. Se omitido em um turno de acompanhamento, o modo da conversa é mantido.
extract, chat Modelo a ser usado na tarefa do agente. spark-2 é o padrão, e todas as execuções são realizadas nele. Os nomes de modelo Spark 1 continuam aceitos para compatibilidade retroativa, mas estão descontinuados e são direcionados para spark-2.
spark-2, spark-1-mini, spark-1-pro Esquema JSON opcional para estruturar os dados extraídos
Se verdadeiro, o agente visitará somente as URLs fornecidas no array urls
Continue uma conversa existente: passe o threadId retornado por uma execução anterior para executar esta solicitação como o próximo turno dessa conversa. As configurações de urls, schema, effort, mode e exchange omitidas são herdadas do turno anterior. Omita threadId para iniciar uma nova conversa.
Substituição por solicitação da Proteção contra ameaças. Os campos fornecidos substituem os campos correspondentes da política da sua organização apenas nesta solicitação; os campos omitidos mantêm os valores definidos no nível da organização. Exige que a Proteção contra ameaças esteja habilitada para sua equipe (recurso enterprise) — caso contrário, a solicitação será rejeitada com 403. Se sua organização tiver desativado substituições por solicitação, qualquer solicitação que inclua este objeto será rejeitada com 403. Se a Proteção contra ameaças for imposta à sua equipe, mode não poderá ser definido como off.
Lista opcional de URLs às quais o agente ficará restrito
Um objeto de especificação de webhook. Inscreve-se em eventos do ciclo de vida do agente (agent.started, agent.action, agent.completed, agent.failed, agent.cancelled).
Execute o agente com Retenção Zero de Dados: o Firecrawl não mantém o conteúdo de prompts, resultados ou etapas em logs ou no armazenamento, apenas metadados de cobrança e status. O resultado fica disponível por 24 horas para consulta e depois é excluído. É necessário que Scrape ZDR e Search ZDR estejam habilitados para sua equipe; caso contrário, o request retorna erro 400 zdr_not_enabled. Não pode ser combinado com threadId. Com exchange, são usadas apenas as capacidades que oferecem suporte a ZDR. Veja Retenção Zero de Dados.

