Dikuasakan AIAutonomi8 credits

agent

Penyelidikan dan pengekstrakan autonomi daripada prompt bahasa tabii — tiada URL diperlukan. Ejen merancang langkahnya sendiri, mencari dan membaca sumbernya sendiri, serta membentuk jawapan di bawah had keselamatan tegas yang dikuatkuasakan oleh orkestrator, bukan oleh model.

Kes Penggunaan

Penyelidikan Terbuka

Jawab soalan yang merentas tapak yang belum anda kenal pasti — ejen menemui sumbernya sendiri dan bukannya menerima senarai URL.

Petikan Persaingan

Tanya tentang tingkat harga semasa atau set ciri pesaing dan dapatkan jawapan tersintesis, bukan timbunan HTML mentah.

Autonomi Bersempadan

max_steps, max_urls dan max_seconds dikuatkuasakan di luar model, jadi satu larian tidak akan melebihi bajet yang anda tetapkan.

Jawapan Boleh Dibaca Mesin

Tetapkan output_format kepada json apabila hasilnya menyuap sistem hiliran dan bukan pembaca manusia.

Endpoint

POST/api/v1/tools/agent

Auth Required

1 req/s pada pelan Free

8 credits

Parameters

Ketiga-tiga had max_* ialah hentian tegas yang dikuatkuasakan oleh orkestrator, bukan cadangan yang dihantar kepada model. Larian yang mencapai salah satu daripadanya akan mengembalikan apa yang telah dikumpulnya, dengan stop_reason menerangkan had yang bertindak.

Name	Type	Required	Default	Description
prompt	string	Required	-	Penerangan dalam bahasa tabii tentang apa yang anda perlukan. Mesti sekurang-kurangnya 10 aksara. Example: Find the current pricing tiers for the top 3 MCP web-scraping providers
max_steps	number	Optional	10	Had tegas bagi langkah perancangan dan pelaksanaan (1-50). Example: 10
max_urls	number	Optional	20	Had tegas bagi bilangan URL yang boleh dilawati ejen (1-100). Example: 20
max_seconds	number	Optional	120	Had tegas masa jam dinding bagi keseluruhan larian, dalam saat (10-600). Example: 120
output_format	string	Optional	"markdown"	Bentuk jawapan: `text`, `json` atau `markdown`. Example: markdown

Contoh Permintaan

cURL

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/agent \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Find the current pricing tiers for the top 3 MCP web-scraping providers",
    "max_steps": 10,
    "max_urls": 20,
    "max_seconds": 120,
    "output_format": "markdown"
  }'

TypeScript

agent.tsTypescript

const response = await fetch('https://crawlforge.dev/api/v1/tools/agent', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.CRAWLFORGE_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'Find the current pricing tiers for the top 3 MCP web-scraping providers',
    max_steps: 10,
    max_urls: 20,
    max_seconds: 120,
    output_format: 'markdown',
  }),
});

const data = await response.json();

if (data.success) {
  console.log('Answer:', data.data.answer);
  console.log('Steps taken:', data.data.steps_taken);
  console.log('Sources read:', data.data.urls_visited);

  // Anything other than 'completed' means a hard limit stopped the run early.
  if (data.data.stop_reason !== 'completed') {
    console.warn('Stopped early:', data.data.stop_reason);
  }

  console.log('Credits used:', data.credits_used);
  console.log('Credits remaining:', data.credits_remaining);
} else {
  console.error('Error:', data.error);
}

Python

agent.pyPython

import requests
import os

response = requests.post(
    'https://crawlforge.dev/api/v1/tools/agent',
    headers={
        'X-API-Key': os.environ['CRAWLFORGE_API_KEY'],
        'Content-Type': 'application/json',
    },
    json={
        'prompt': 'Find the current pricing tiers for the top 3 MCP web-scraping providers',
        'max_steps': 10,
        'max_urls': 20,
        'max_seconds': 120,
        'output_format': 'markdown'
    }
)

data = response.json()

if data['success']:
    print(f"Answer: {data['data']['answer']}")
    print(f"Steps taken: {data['data']['steps_taken']}")
    print(f"Sources read: {data['data']['urls_visited']}")

    # Anything other than 'completed' means a hard limit stopped the run early.
    if data['data']['stop_reason'] != 'completed':
        print(f"Stopped early: {data['data']['stop_reason']}")

    print(f"Credits used: {data['credits_used']}")
    print(f"Credits remaining: {data['credits_remaining']}")
else:
    print(f"Error: {data['error']}")

Contoh Respons

200 OK8420ms

{
  "success": true,
  "data": {
    "prompt": "Find the current pricing tiers for the top 3 MCP web-scraping providers",
    "answer": "## Pricing comparison\n\n- **CrawlForge** — Free (1,000 credits), Hobby $19/mo, Professional $99/mo...",
    "output_format": "markdown",
    "steps_taken": 6,
    "urls_visited": [
      "https://example.com/pricing",
      "https://example.org/plans"
    ],
    "limits": {
      "max_steps": 10,
      "max_urls": 20,
      "max_seconds": 120
    },
    "stop_reason": "completed"
  },
  "credits_used": 8,
  "credits_remaining": 992,
  "processing_time": 8420
}

Field Descriptions

data.answerJawapan tersintesis, dipaparkan dalam `output_format` yang diminta

data.steps_takenBerapa banyak langkah perancangan/pelaksanaan yang benar-benar digunakan

data.urls_visitedSetiap URL yang dibaca ejen semasa menjawab — gunakannya untuk mengaudit sumber

data.limitsMengulang semula hentian tegas yang berkuat kuasa bagi larian ini

data.stop_reason`completed` apabila ejen selesai dengan sendirinya; jika tidak, had yang menghentikannya

credits_usedCredits yang ditolak bagi larian ini (8 setiap larian, tidak kira bilangan langkah)

credits_remainingBaki credits anda

Pengendalian Ralat

Input Tidak Sah (400 Bad Request)

Prompt lebih pendek daripada 10 aksara, atau nilai max_* berada di luar julat yang dibenarkan (max_steps 1-50, max_urls 1-100, max_seconds 10-600).

Larian Ejen Gagal (500 Internal Server Error)

Larian tidak dapat diselesaikan. Credits tidak ditolak bagi larian yang gagal — cuba semula dengan prompt yang lebih sempit atau max_steps yang lebih kecil.

Credits Tidak Mencukupi (402 Payment Required)

Akaun anda tidak mempunyai credits yang mencukupi. Beli lebih banyak credits atau naik taraf pelan anda.

Had Kadar Dilampaui (429 Too Many Requests)

Anda telah melampaui had kadar pelan anda. Tunggu sebentar atau naik taraf pelan anda untuk had yang lebih tinggi.

Petua Pro: Larian yang mengembalikan stop_reason selain completed tetap berkos 8 credits. Mulakan dengan max_seconds yang ketat semasa anda memperhalus prompt, kemudian naikkannya apabila ejen selesai dengan sendirinya secara konsisten.

Kos Credits

8 credits

8 credits setiap larian

Setiap larian agent berkos 8 credits rata tidak kira berapa banyak langkah yang diambilnya atau berapa banyak URL yang dilawatinya — had yang anda tetapkan mengehadkan masa jam dinding, bukan harga.

Pelan Free: 1,000 credits sekali sahaja = 125 larian

Pelan Hobby: 5,000 credits/bulan = 625 larian (USD 19/bulan)

Pelan Professional: 50,000 credits/bulan = 6,250 larian (USD 99/bulan)

Pelan Business: 250,000 credits/bulan = 31,250 larian (USD 399/bulan)

Alat Berkaitan

deep_research

Penyelidikan berbilang peringkat dengan pengesahan sumber dan sintesis (10 credits)

search_web

Carian web berstruktur apabila anda mahu memilih sumber sendiri (5 credits)

extract_with_llm

Pengekstrakan LLM daripada halaman yang sudah anda miliki (3 credits)

scrape

Pengekstrakan berbilang format daripada satu URL yang diketahui (2 credits)

Sedia mencuba agent? Daftar secara percuma dan dapatkan 1,000 credits untuk mula membina.

Kes Penggunaan

Penyelidikan Terbuka

Jawab soalan yang merentas tapak yang belum anda kenal pasti — ejen menemui sumbernya sendiri dan bukannya menerima senarai URL.

Petikan Persaingan

Tanya tentang tingkat harga semasa atau set ciri pesaing dan dapatkan jawapan tersintesis, bukan timbunan HTML mentah.

Autonomi Bersempadan

max_steps, max_urls dan max_seconds dikuatkuasakan di luar model, jadi satu larian tidak akan melebihi bajet yang anda tetapkan.

Jawapan Boleh Dibaca Mesin

Tetapkan output_format kepada json apabila hasilnya menyuap sistem hiliran dan bukan pembaca manusia.

Parameters

Name	Type	Required	Default	Description
prompt	string	Required	-	Penerangan dalam bahasa tabii tentang apa yang anda perlukan. Mesti sekurang-kurangnya 10 aksara. Example: Find the current pricing tiers for the top 3 MCP web-scraping providers
max_steps	number	Optional	10	Had tegas bagi langkah perancangan dan pelaksanaan (1-50). Example: 10
max_urls	number	Optional	20	Had tegas bagi bilangan URL yang boleh dilawati ejen (1-100). Example: 20
max_seconds	number	Optional	120	Had tegas masa jam dinding bagi keseluruhan larian, dalam saat (10-600). Example: 120
output_format	string	Optional	"markdown"	Bentuk jawapan: `text`, `json` atau `markdown`. Example: markdown

Contoh Permintaan

cURL

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/agent \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Find the current pricing tiers for the top 3 MCP web-scraping providers",
    "max_steps": 10,
    "max_urls": 20,
    "max_seconds": 120,
    "output_format": "markdown"
  }'

TypeScript

agent.tsTypescript

const response = await fetch('https://crawlforge.dev/api/v1/tools/agent', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.CRAWLFORGE_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'Find the current pricing tiers for the top 3 MCP web-scraping providers',
    max_steps: 10,
    max_urls: 20,
    max_seconds: 120,
    output_format: 'markdown',
  }),
});

const data = await response.json();

if (data.success) {
  console.log('Answer:', data.data.answer);
  console.log('Steps taken:', data.data.steps_taken);
  console.log('Sources read:', data.data.urls_visited);

  // Anything other than 'completed' means a hard limit stopped the run early.
  if (data.data.stop_reason !== 'completed') {
    console.warn('Stopped early:', data.data.stop_reason);
  }

  console.log('Credits used:', data.credits_used);
  console.log('Credits remaining:', data.credits_remaining);
} else {
  console.error('Error:', data.error);
}

Python

agent.pyPython

import requests
import os

response = requests.post(
    'https://crawlforge.dev/api/v1/tools/agent',
    headers={
        'X-API-Key': os.environ['CRAWLFORGE_API_KEY'],
        'Content-Type': 'application/json',
    },
    json={
        'prompt': 'Find the current pricing tiers for the top 3 MCP web-scraping providers',
        'max_steps': 10,
        'max_urls': 20,
        'max_seconds': 120,
        'output_format': 'markdown'
    }
)

data = response.json()

if data['success']:
    print(f"Answer: {data['data']['answer']}")
    print(f"Steps taken: {data['data']['steps_taken']}")
    print(f"Sources read: {data['data']['urls_visited']}")

    # Anything other than 'completed' means a hard limit stopped the run early.
    if data['data']['stop_reason'] != 'completed':
        print(f"Stopped early: {data['data']['stop_reason']}")

    print(f"Credits used: {data['credits_used']}")
    print(f"Credits remaining: {data['credits_remaining']}")
else:
    print(f"Error: {data['error']}")

Contoh Respons

200 OK8420ms

{
  "success": true,
  "data": {
    "prompt": "Find the current pricing tiers for the top 3 MCP web-scraping providers",
    "answer": "## Pricing comparison\n\n- **CrawlForge** — Free (1,000 credits), Hobby $19/mo, Professional $99/mo...",
    "output_format": "markdown",
    "steps_taken": 6,
    "urls_visited": [
      "https://example.com/pricing",
      "https://example.org/plans"
    ],
    "limits": {
      "max_steps": 10,
      "max_urls": 20,
      "max_seconds": 120
    },
    "stop_reason": "completed"
  },
  "credits_used": 8,
  "credits_remaining": 992,
  "processing_time": 8420
}

Field Descriptions

data.answerJawapan tersintesis, dipaparkan dalam `output_format` yang diminta

data.steps_takenBerapa banyak langkah perancangan/pelaksanaan yang benar-benar digunakan

data.urls_visitedSetiap URL yang dibaca ejen semasa menjawab — gunakannya untuk mengaudit sumber

data.limitsMengulang semula hentian tegas yang berkuat kuasa bagi larian ini

data.stop_reason`completed` apabila ejen selesai dengan sendirinya; jika tidak, had yang menghentikannya

credits_usedCredits yang ditolak bagi larian ini (8 setiap larian, tidak kira bilangan langkah)

credits_remainingBaki credits anda

Pengendalian Ralat

Input Tidak Sah (400 Bad Request)

Prompt lebih pendek daripada 10 aksara, atau nilai max_* berada di luar julat yang dibenarkan (max_steps 1-50, max_urls 1-100, max_seconds 10-600).

Larian Ejen Gagal (500 Internal Server Error)

Larian tidak dapat diselesaikan. Credits tidak ditolak bagi larian yang gagal — cuba semula dengan prompt yang lebih sempit atau max_steps yang lebih kecil.

Credits Tidak Mencukupi (402 Payment Required)

Akaun anda tidak mempunyai credits yang mencukupi. Beli lebih banyak credits atau naik taraf pelan anda.

Had Kadar Dilampaui (429 Too Many Requests)

Anda telah melampaui had kadar pelan anda. Tunggu sebentar atau naik taraf pelan anda untuk had yang lebih tinggi.

Kos Credits

8 credits

8 credits setiap larian

Pelan Free: 1,000 credits sekali sahaja = 125 larian

Pelan Hobby: 5,000 credits/bulan = 625 larian (USD 19/bulan)

Pelan Professional: 50,000 credits/bulan = 6,250 larian (USD 99/bulan)

Pelan Business: 250,000 credits/bulan = 31,250 larian (USD 399/bulan)