0iG d Z ddlZddlZddlZddlZddlmZ ddlZddlZddl m
Z
ddl m Z ej dd ZdZd Zd
Ze
d5d eed f d
eedf defd Ze
d6deedf deedf defd ZdedefdZdee dee fdZe
d7d eedf deed f defd Zd Zd d eeeegd!Z e
d8d eedf deed#f defd$ Z ej= d%d& Z d e d' e e eegd!Z e!d(k( rv e"d) ejG d*d+d, Z$ e"e$dd- e"d. ejG d/d0d1 Z$ e"e$dd- e"d2 ejG d3d"d4 Z$ e"e$dd0 yy)9u
Jina AI Tools for DeepAgents
=============================
Tool 1: jina_search — s.jina.ai 语义网络搜索（返回 top-N 结构化结果）
Tool 2: jina_reader — r.jina.ai 单 URL 全文提取（返回 Markdown）
Tool 3: jina_deepsearch — deepsearch.jina.ai 深度研究（流式，返回带引用的文章）
SubAgent: jina-writer — deepagents 兼容的文章撰写子 agent
N) Annotated)tool)get_stream_writer JINA_API_KEY zhttps://s.jina.ai/zhttps://r.jina.ai/z.https://deepsearch.jina.ai/v1/chat/completionsqueryu/ Search query — describe what you want to find num_resultsz-Number of results to return (1-10, default 5)returnc dt dddd}| t dt d| d} t j t
||d
}|j
|j }|j d
g }|syg }t |d D ] \ } }
|
j dd } |
j dd } |
j d xs |
j d xs dj }
|
d d t |
dkD rdndz }
|j d| d| d| d|
dj | S # t j $ r}d | cY d }~S d }~ww xY w) a Search the web using Jina AI (s.jina.ai).
Returns top results as LLM-friendly markdown with title, URL, and content.
Use this for: current events, factual lookup, finding primary sources.
Each result is capped at 2000 chars to stay within context limits.
Bearer application/jsontruemarkdown)
AuthorizationAcceptX-With-Links-SummaryX-Return-Format
)qnum )headersjsontimeoutz[jina_search error] NdatazNo results found.titleUntitledurlr content descriptioni u …[z] **z**
URL:
z
---
)r maxminrequestspost _SEARCH_URLraise_for_statusr RequestExceptionget enumeratestriplenappendjoin)r r r payloadrespr eitemspartsiitemr r r s +/home/yzq/tmp/tech/deepagents/jina_tools.py jina_searchr9 sp #<.1$ &% G 1c"k*+G
*}}
yy{
HHVR E " E UA& D4*-hhub!88I&G$((=*AGRNNP%4.S\D-@EbI
q4wiuD BC D e $$ $ $ *%aS))*s =D1 1EEEEr z9Full URL of the page to read (must start with http/https) max_charsz'Max characters to return (default 6000)c | j d sydt dddd} t j t | |d }|j |j
}|j d i }|j d
| }|j d xs dj }|sd| S |d | t | |kD rdndz } d| d| d| S # t j $ r}d
| cY d }~S d }~ww xY w)a4 Read and extract clean Markdown content from a URL using Jina AI (r.jina.ai).
Use this for: reading a specific article, report, or document in full;
following up on a search result; extracting structured content from a page.
Returns the page title + full markdown body, capped at max_chars.
httpz;[jina_reader error] URL must start with http:// or https://r r
r false)r r r r r )r r z[jina_reader error] Nr r r r z([jina_reader] No content extracted from u …[truncated]z# z
Source: r# )
startswithr r& r+ _READER_URLr) r r* r- r. )
r r: r r2 r r3 r1 r r truncateds
r8 jina_readerrA U s >>& !L #<.1$% ' G *||mC5 !
yy{ hhvr"G KK %E{{9%+224G 9#??
#3w<);S'7Y[\I
wjT) 55 $ $ *%aS))*s A C C5&C0*C50C5textc l t j dd| t j j S )zBRemove ... reasoning blocks from DeepSearch output.z.*?r )flags)resubDOTALLr- )rB s r8 _strip_thinkingrH s%
66'T C I I KK citationsc t g }}| D ]> }|j dd }|s||vs |j | |j | @ |S )Nr r )setr+ addr/ )rJ seenuniquecr s r8 _dedupe_citationsrQ sS 5"&D
eeE2 3d? HHSM MM!
MrI z1Research question or article topic to investigatereasoning_effortz[Depth of research: 'low' (fast, ~30s), 'medium' (balanced, ~1min), 'high' (thorough, ~3min)c 6 dt ddd}dd| dgd|dd }d
}g } t j t ||dd 5 }|j |j D ]= }|st
|t r|j d
n|}|j d s<|dd j } | dk( r n t j | }
|
j d xs i gd } | j di } | j d xs d
}
|
r||
z
}| j d xs |
j d xs g D ]` }t
|t s|j d dk( s)|j d xs |}|j d sP|j | b @ ddd |syt' | }t) | }t+ j, d |t* j. }|ra|s_|d z
}t1 |d D ]K \ }}|j d xs |j dd
}|j dd
}|d | d!| d"| d#z
}M |S # t j t" f$ r Y w xY w# 1 sw Y xY w# t j$ $ r}d| cY d}~S d}~ww xY w)$u, Conduct deep web research using Jina AI DeepSearch.
Autonomously plans search strategies, reads multiple sources, reasons over
evidence, and returns a well-cited research synthesis or article.
Use this for:
- Writing comprehensive articles or reports
- Multi-source research requiring synthesis
- Questions needing up-to-date information with citations
Returns the full research result with inline citations and a Sources section.
NOTE: This tool is slow (30s – 3min). Use reasoning_effort='low' for quick lookups.
r r
text/event-streamr z Content-Typer jina-deepsearch-v1userroler TmodelmessagesstreamrR no_direct_answerr , )r r r] r zutf-8data: N[DONE]choicesr deltar annotationstype url_citationr z[jina_deepsearch error] z&[jina_deepsearch] No content returned.u ^## (Sources|References|参考)
## Sources
r r r" ] —
)r r& r' _DEEPSEARCH_URLr)
iter_lines
isinstancebytesdecoder> r- r loadsr+ dictr/ JSONDecodeErrorKeyErrorr* rH rQ rE search MULTILINEr, )r rR r r1 full_contentrJ r2 raw_linelinedata_strchunkchoicerd
content_pieceannucr3 answerunique_citations has_sourcesr6 rP r r s r8 jina_deepsearchr s , #<.1*%G & $78 , G L I*.
]]
& ! ! # OO -
3=h3Nxw/T\x0 8>>+x' JJx 0E #ii 2 :rdA >F "JJw 3E %*IIi$8$>BM$$
5 !& - 8 ZEIIm UK $$ .2 3DAqEE'N6aeeE2&6E%%r"C !BugU3%r2 2F 3
M- ,,h7 K& & P $ $ .)!--.sf I6 A7I*5B,I
"&I
I
I* I6
I'#I*&I''I**I3/I6 6J J
JJu You are an expert research writer powered by Jina AI.
## Role
Given a writing request (article, report, analysis, summary), you:
1. Research the topic thoroughly using jina_deepsearch
2. Optionally deepen specific angles using jina_search + jina_reader
3. Synthesize all findings into a well-structured, citation-backed piece
## Tools Available
- `jina_deepsearch(query, reasoning_effort)` — primary: deep multi-source research with citations
- `jina_search(query, num_results)` — supplement: targeted keyword searches
- `jina_reader(url)` — supplement: read a specific source in full
## Writing Process
### Step 1 — Understand the request
Identify: topic scope, target length, required sections, target audience, tone (technical / general).
### Step 2 — Research
- Call `jina_deepsearch` with the core topic
- Use `reasoning_effort="high"` for long-form articles or reports (>1000 words)
- Use `reasoning_effort="medium"` for standard pieces
- Use `reasoning_effort="low"` for quick summaries
- If specific sub-topics need more depth, call `jina_search` then `jina_reader` on key URLs
### Step 3 — Write the article
Synthesize all research into a coherent piece. Structure:
```
# [Title]
## Introduction / Executive Summary
## [Section 1]
[content with inline citations [1][2]]
## [Section 2 … N]
## Conclusion / Key Takeaways
## References
[1] Title — URL
[2] ...
```
## Citation Rules
- Every factual claim must carry an inline citation: [1], [2], etc.
- Consolidate all URLs into a References section at the end
- Do not fabricate sources — only cite what jina_deepsearch or jina_reader actually returned
## Output
Return the complete article in Markdown. Do NOT return a raw dump of DeepSearch output —
write a proper article that synthesizes the research.
z jina-writera* Writes comprehensive, citation-backed articles and research reports using Jina AI DeepSearch for up-to-date web research. Use for: long-form articles, market research, topic overviews, technical summaries requiring current sources. Pass: article topic, desired length/sections, and target audience.)namer!
system_prompttoolslowz5Depth: 'low' (~60s), 'medium' (~3min), 'high' (~5min)c 4 K t }dt ddd}dd| dgd|dd }d
}g }d }d
} t j d
4 d{ } | j dt
|| 4 d{ }
|
j
|
j 2 3 d{ } | j d s| dd j } | dk( r n t j | }
|
j d xs i gd }|j di }|j d xs d
}|r:||z
}|s+||z
}d|v r*d}|j dd d }|r || n || |j d xs |
j d xs g D ]` }t |t s|j d d k( s)|j d xs |}|j d sP|j! | b Uddd d{ ddd d{ |sy t+ | }t- | }|r}t/ j0 d |t. j2 sX|d!z
}t5 |d D ]D \ }}|d"| d#|j d$|j d d
d%|j d d
d&z
}F |S 7 V7 77 # t j" t$ t& f$ r Y 9w xY w6 7 # 1 d{ 7 sw Y xY w7 # 1 d{ 7 sw Y xY w# t( $ r}d | cY d}~S d}~ww xY ww)'aM Deep web research with REAL-TIME streaming output.
Uses Jina AI DeepSearch and pushes answer tokens to the stream as they
arrive via get_stream_writer(). The reasoning block is suppressed;
only the final answer content streams out.
Use this instead of jina_deepsearch when the caller needs live output.
r r
rT rU rV rW rX TrZ r Fr_ )r NPOST)r r r` ra rb rc r rd r zr re rf rg r z [jina_deepsearch_stream error] z-[jina_deepsearch_stream] No content returned.z^## (Sources|References)rh r" ri r rj rk )r r httpx AsyncClientr] rl r) aiter_linesr> r- r rq r+ splitrn rr r/ rs rt
IndexError ExceptionrH rQ rE ru rv r, )r rR writer r1 rw rJ
thinking_done think_bufclientr2 rx rz r{ r| rd pieceafterr~ r r3 r rO r6 rP s r8 jina_deepsearch_streamr D sH
E #<.1*%G & $78 , G L I MI*5$$S1 & ! & !V }}w % %
! %
!%%'&*&6&6&8 !! !!(#..x8 '| 1 1 3H 8+ ! $
8 4"'))I"6">2$!B &
7B 7 % ) 4 : (E 1L#0 )U 2 #-#:48M,5OOJ,J1,ME',(-e %e %*IIm$<$^ -@X$^\^ 9C )#t 4 N9Z%(WW^%<%C#%66%=$-$4$4R$8 9=%
! %
!& ! & !V >
\
*F
y
)F
bii ;VR\\R$$ fa( YDAq !BquuWaeeE"o > ?uQUU5QS_DUUWX XF Y Mk& !%
!!!@ ! 0 0(JG ! !A '9 %
! %
! %
! %
!& ! & ! & ! & !P 50445s ,LK= J
K=
K(+J",K(/!KK
J%
K
.KC J(J()&J(J(#K% K(0K1K(5 K= K&K= BL K= "K(%K
( K
K K
KK(K# KK# K(&K= (K:.K1 /K:6K= = LL
L LLLz(jina_deepsearch(query, reasoning_effort)z/jina_deepsearch_stream(query, reasoning_effort)r! __main__z=== jina_search ===zJina AI DeepSearch API 2025 )r r i z
=== jina_reader ===zhttps://jina.ai/deepsearchi )r r: z
=== jina_deepsearch ===zMWhat are the key differences between RAG and DeepSearch for LLM applications?)r rR ) )ip )medium)r )%__doc__asyncior osrE typingr r r& langchain_core.toolsr langgraph.configr getenvr r( r? rl strintr9 rA rH listrr rQ r JINA_WRITER_INSTRUCTIONSjina_writer_subagentr replace JINA_WRITER_STREAM_INSTRUCTIONSjina_writer_stream_subagent__name__printinvokeresult rI r8 r s % .ryy , " " B TU-% SKK L-%3 OOP-% -% -%h LP'6 3SS T'6 GGH'6 '6 '6\L# L# L
d T
` SMM N` e g`
` `P4 n
M . {K
8 $ [ SMM N[ ? A[
[ [~ #;"B"B.5#
'
64$k;
? z
*GXY Z
[F &#,
!"
(DSW X
YF &#,
%&
#
#` !% F
&$-# rI