Endpoints

AI deep dive

Cited AI answers about a part

Ask Zenode's AI specific questions about a part and get back formatted, cited answers. Each question is a deliverable; asking several related deliverables in one call often improves quality, because the AI researches them together.

ai:run

This endpoint runs an AI agent, so it's asynchronous: it returns a job you poll or stream for the result.

POSThttps://api.zenode.ai/v1/parts/{manufacturer}/{mpn}/deep-dive

202Accepted Job (type: deep_dive)

The part is the (manufacturer slug, mpn_slug) path pair, as in part detail. 404Not Found not_found if the pair matches no part.

Request

JSON

1{
2  "deliverables": [
3    {
4      "key": "input_bias_current",
5      "question": "Input bias current at room temperature — is it a guaranteed max or a typical value?",
6      "response_format": {
7        "type": "number",
8        "unit": "pA",
9        "hint": "room temperature; note typ vs max"
10      }
11    },
12    {
13      "key": "rohs",
14      "question": "Is this part RoHS compliant?",
15      "response_format": {
16        "type": "enum",
17        "enum_values": [
18          "compliant",
19          "non_compliant",
20          "unknown"
21        ]
22      }
23    }
24  ],
25  "context": {
26    "operating_condition": "Vs = ±15 V"
27  }
28}

Parameter	Type	Required	Description
`deliverables`	Deliverable[]	Required	One or more questions to answer, researched together
`context`	object \| null	Optional	Optional key/value context shared by all deliverables

Each Deliverable is { key, question, response_format }:

Parameter	Type	Required	Description
`key`	string	Optional	Correlation key echoed on the matching answer; defaults to the array index
`question`	string	Required	The question to answer about this part
`response_format`	ResponseFormat	Optional	Desired answer shape (text, number, enum, list, JSON); default { type: markdown }

Each deliverable is metered and billed as a separate AI item. See Rate limits & usage.

Result

The job's result is a DeepDiveResult (when type is deep_dive) — one answer per deliverable, in request order:

JSON

1{
2  "answers": [
3    {
4      "key": "input_bias_current",
5      "question": "Input bias current at room temperature — is it a guaranteed max or a typical value?",
6      "value": 65,
7      "value_type": "number",
8      "display": "65 pA (typ)",
9      "explanation": "The Electrical Characteristics table lists input bias current as 65 pA typical at 25°C; no guaranteed maximum is specified at room temperature.",
10      "citations": [
11        {
12          "document_name": "TL07xx … Datasheet",
13          "document_type": "Datasheet",
14          "quote": "Input bias current … 65 pA (typ), 25°C",
15          "url": "https://zenode.ai/datasheets/ti-tl072-datasheet-3f8a#p5"
16        }
17      ],
18      "usage": {
19        "input_tokens": 9120,
20        "output_tokens": 840,
21        "total_tokens": 9960
22      },
23      "status": "answered"
24    }
25  ]
26}

Each item is an Answer: the formatted value (per the requested ResponseFormat), a plain-language explanation, a per-item usage breakdown, a status (answered / not_available / error), and supporting Citations — each linking to the Zenode page for the source.

Async AI jobs — poll, stream, and read usage
AI part discovery

PreviousAI part discovery Next Async AI jobs