How agent works
The current agent loop is intentionally narrow.
Tool order
- receive your instruction
- decide whether
scrape,map,interact, orresearchis the next best tool - evaluate the tool result
- either continue or
finalize
Termination reasons
satisfiedmax_stepsbudgettool_error
Response shape
The response includes:
statusanswersourcestrailsteps_usedcost_usdcost_breakdownterminated_reason
Agent loop request
```bash
curl https://api.faircompany.ai/v1/crawl/agent \
-X POST \
-H "Authorization: Bearer fc_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"instruction": "Find Stripe's current standard card pricing and return the answer with sources.",
"max_steps": 6,
"budget_usd": 0.05
}'
```
```ts
const answer = await fc.agent({
instruction: "Find Stripe's current standard card pricing and return the answer with sources.",
max_steps: 6,
budget_usd: 0.05,
});
console.log(answer.answer);
console.log(answer.sources);
```
```python
answer = fc.agent(
"Find Stripe's current standard card pricing and return the answer with sources.",
max_steps=6,
budget_usd=0.05,
)
print(answer.answer)
print(answer.sources)
```
```json
{
"tool": "faircrawl_agent",
"arguments": {
"instruction": "Find Stripe's current standard card pricing and return the answer with sources.",
"max_steps": 6,
"budget_usd": 0.05
}
}
```