{"id":30636,"date":"2025-04-22T10:43:29","date_gmt":"2025-04-22T02:43:29","guid":{"rendered":"https:\/\/www.aisharenet.com\/?p=30636"},"modified":"2025-04-22T10:43:29","modified_gmt":"2025-04-22T02:43:29","slug":"docagent","status":"publish","type":"post","link":"https:\/\/www.kdjingpai.com\/ja\/docagent\/","title":{"rendered":"DocAgent\uff1a\u81ea\u52a8\u751f\u6210Python\u4ee3\u7801\u6587\u6863\u7684\u667a\u80fd\u5de5\u5177"},"content":{"rendered":"<p>DocAgent \u662f\u4e00\u4e2a\u7531 <a href=\"https:\/\/www.kdjingpai.com\/ja\/meta-ai\/\">Meta AI<\/a> \u5f00\u53d1\u3001\u5f00\u6e90\u7684 Python \u4ee3\u7801\u6587\u6863\u751f\u6210\u5de5\u5177\u3002\u5b83\u901a\u8fc7\u591a\u667a\u80fd\u4f53\u534f\u4f5c\u548c\u5c42\u6b21\u5316\u4ee3\u7801\u5206\u6790\uff0c\u81ea\u52a8\u4e3a Python \u4ee3\u7801\u5e93\u751f\u6210\u9ad8\u8d28\u91cf\u3001\u4e0a\u4e0b\u6587\u611f\u77e5\u7684\u6587\u6863\u6ce8\u91ca\uff08docstrings\uff09\u3002DocAgent \u89e3\u51b3\u4e86\u4f20\u7edf\u8bed\u8a00\u6a21\u578b\u751f\u6210\u6587\u6863\u65f6\u7f3a\u4e4f\u6df1\u5ea6\u548c\u4e0a\u4e0b\u6587\u7684\u95ee\u9898\uff0c\u80fd\u591f\u5206\u6790\u4ee3\u7801\u4f9d\u8d56\u5173\u7cfb\uff0c\u751f\u6210\u7b80\u6d01\u3001\u51c6\u786e\u7684\u6587\u6863\u3002\u5b83\u9002\u5408\u5f00\u53d1\u8005\u548c\u56e2\u961f\u63d0\u5347\u4ee3\u7801\u53ef\u8bfb\u6027\u548c\u7ef4\u62a4\u6027\u3002\u9879\u76ee\u6258\u7ba1\u5728 GitHub\uff0c\u91c7\u7528 MIT \u8bb8\u53ef\u8bc1\uff0c\u652f\u6301\u672c\u5730\u548c\u4e91\u7aef\u90e8\u7f72\uff0c\u914d\u5907 Web \u754c\u9762\u4fbf\u4e8e\u64cd\u4f5c\u3002<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-30637\" title=\"DocAgent\uff1a\u81ea\u52a8\u751f\u6210Python\u4ee3\u7801\u6587\u6863\u7684\u667a\u80fd\u5de5\u5177-1\" src=\"https:\/\/www.kdjingpai.com\/wp-content\/uploads\/2025\/04\/0ec795d77de7d99.jpg\" alt=\"DocAgent\uff1a\u81ea\u52a8\u751f\u6210Python\u4ee3\u7801\u6587\u6863\u7684\u667a\u80fd\u5de5\u5177-1\" width=\"2560\" height=\"826\" \/><\/p>\n<p>&nbsp;<\/p>\n<h2>\u529f\u80fd\u5217\u8868<\/h2>\n<ul>\n<li>\u81ea\u52a8\u751f\u6210\u4e0a\u4e0b\u6587\u611f\u77e5\u7684 Python \u4ee3\u7801\u6587\u6863\u6ce8\u91ca\uff08docstrings\uff09\u3002<\/li>\n<li>\u901a\u8fc7\u591a\u667a\u80fd\u4f53\u7cfb\u7edf\u5206\u6790\u4ee3\u7801\u7ed3\u6784\u548c\u4f9d\u8d56\u5173\u7cfb\u3002<\/li>\n<li>\u652f\u6301\u5c42\u6b21\u5316\u4ee3\u7801\u904d\u5386\uff0c\u4f18\u5148\u5904\u7406\u4f9d\u8d56\u8f83\u5c11\u7684\u4ee3\u7801\u6587\u4ef6\u3002<\/li>\n<li>\u63d0\u4f9b Web \u754c\u9762\uff0c\u7528\u4e8e\u914d\u7f6e\u3001\u8fd0\u884c\u548c\u5b9e\u65f6\u76d1\u63a7\u6587\u6863\u751f\u6210\u8fc7\u7a0b\u3002<\/li>\n<li>\u5305\u542b\u6587\u6863\u8d28\u91cf\u8bc4\u4f30\u5de5\u5177\uff0c\u57fa\u4e8e\u9759\u6001\u4ee3\u7801\u5206\u6790\uff08AST\uff09\u68c0\u67e5\u5b8c\u6574\u6027\u3002<\/li>\n<li>\u652f\u6301\u672c\u5730\u6216\u4e91\u7aef\u5927\u8bed\u8a00\u6a21\u578b\uff08LLM\uff09\u914d\u7f6e\uff0c\u7075\u6d3b\u9002\u914d\u4e0d\u540c\u73af\u5883\u3002<\/li>\n<li>\u63d0\u4f9b\u793a\u4f8b\u914d\u7f6e\u6587\u4ef6\uff0c\u7b80\u5316\u521d\u59cb\u8bbe\u7f6e\u6d41\u7a0b\u3002<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h2>\u4f7f\u7528\u5e2e\u52a9<\/h2>\n<h3>\u5b89\u88c5\u6d41\u7a0b<\/h3>\n<p>DocAgent \u9700\u8981 Python \u73af\u5883\uff08\u63a8\u8350 Python 3.8 \u6216\u4ee5\u4e0a\uff09\u3002\u4ee5\u4e0b\u662f\u8be6\u7ec6\u5b89\u88c5\u6b65\u9aa4\uff1a<\/p>\n<ol>\n<li><strong>\u514b\u9686\u4ee3\u7801\u5e93<\/strong><br \/>\n\u5728\u7ec8\u7aef\u8fd0\u884c\u4ee5\u4e0b\u547d\u4ee4\uff0c\u5c06 DocAgent \u9879\u76ee\u514b\u9686\u5230\u672c\u5730\uff1a<\/p>\n<pre><code>git clone https:\/\/github.com\/facebookresearch\/DocAgent.git\r\ncd DocAgent\r\n<\/code><\/pre>\n<\/li>\n<li><strong>\u5b89\u88c5\u4f9d\u8d56<\/strong><br \/>\n\u4f7f\u7528 pip \u5b89\u88c5\u6240\u9700 Python \u5e93\u3002\u5efa\u8bae\u521b\u5efa\u865a\u62df\u73af\u5883\u4ee5\u907f\u514d\u51b2\u7a81\uff1a<\/p>\n<pre><code>python -m venv venv\r\nsource venv\/bin\/activate  # Windows \u4f7f\u7528 venv\\Scripts\\activate\r\npip install -r requirements.txt\r\n<\/code><\/pre>\n<\/li>\n<li><strong>\u914d\u7f6e\u6a21\u578b\u548c\u73af\u5883<\/strong><br \/>\nDocAgent \u9700\u8981\u914d\u7f6e\u5927\u8bed\u8a00\u6a21\u578b\uff08LLM\uff09API \u6216\u672c\u5730\u6a21\u578b\u3002\u590d\u5236\u793a\u4f8b\u914d\u7f6e\u6587\u4ef6\u5e76\u4fee\u6539\uff1a<\/p>\n<pre><code>cp config\/example_config.yaml config\/agent_config.yaml\r\n<\/code><\/pre>\n<p>\u4f7f\u7528\u6587\u672c\u7f16\u8f91\u5668\u6253\u5f00\u00a0<code>config\/agent_config.yaml<\/code>\uff0c\u6839\u636e\u9700\u8981\u8bbe\u7f6e\u4ee5\u4e0b\u53c2\u6570\uff1a<\/p>\n<ul>\n<li><code>llm_endpoint<\/code>\uff1aLLM API \u5730\u5740\uff08\u5982 Hugging Face \u6216\u5176\u4ed6\u670d\u52a1\uff09\u3002<\/li>\n<li><code>api_key<\/code>\uff1a\u5982\u679c\u4f7f\u7528\u4e91\u7aef LLM\uff0c\u586b\u5199 API \u5bc6\u94a5\u3002<\/li>\n<li><code>model_name<\/code>\uff1a\u6307\u5b9a\u4f7f\u7528\u7684\u6a21\u578b\u540d\u79f0\u3002<\/li>\n<li><code>generation_settings<\/code>\uff1a\u8c03\u6574\u751f\u6210\u6587\u6863\u7684\u683c\u5f0f\u548c\u98ce\u683c\u3002<\/li>\n<\/ul>\n<p>\u793a\u4f8b\u914d\u7f6e\u7247\u6bb5\uff1a<\/p>\n<pre><code>llm_endpoint: \"http:\/\/localhost:8000\"\r\nmodel_name: \"gpt-3.5-turbo\"\r\ngeneration_settings:\r\nmax_tokens: 512\r\ntemperature: 0.7\r\n<\/code><\/pre>\n<\/li>\n<li><strong>\u542f\u52a8 Web \u754c\u9762<\/strong><br \/>\nDocAgent \u63d0\u4f9b\u76f4\u89c2\u7684 Web \u754c\u9762\uff0c\u7528\u4e8e\u914d\u7f6e\u548c\u76d1\u63a7\u6587\u6863\u751f\u6210\u3002\u8fd0\u884c\u4ee5\u4e0b\u547d\u4ee4\u542f\u52a8\u670d\u52a1\u5668\uff1a<\/p>\n<pre><code>python run_web_ui.py --host 0.0.0.0 --port 5000\r\n<\/code><\/pre>\n<p>\u6253\u5f00\u6d4f\u89c8\u5668\uff0c\u8bbf\u95ee\u00a0<code>http:\/\/localhost:5000<\/code>\u3002\u5982\u679c\u5728\u8fdc\u7a0b\u670d\u52a1\u5668\u8fd0\u884c\uff0c\u53ef\u80fd\u9700\u8981\u8bbe\u7f6e SSH \u96a7\u9053\uff1a<\/p>\n<pre><code>ssh -L 5000:localhost:5000 &lt;your_remote_username&gt;@&lt;your_remote_host&gt;\r\n<\/code><\/pre>\n<\/li>\n<\/ol>\n<h3>\u4f7f\u7528\u6587\u6863\u751f\u6210\u529f\u80fd<\/h3>\n<ol>\n<li><strong>\u51c6\u5907\u4ee3\u7801\u5e93<\/strong><br \/>\n\u5c06\u9700\u8981\u751f\u6210\u6587\u6863\u7684 Python \u4ee3\u7801\u5e93\u8def\u5f84\u914d\u7f6e\u5230 Web \u754c\u9762\u6216\u547d\u4ee4\u884c\u3002\u786e\u4fdd\u4f7f\u7528\u7edd\u5bf9\u8def\u5f84\uff0c\u4f8b\u5982\uff1a<\/p>\n<pre><code>\/home\/user\/projects\/my_python_repo\r\n<\/code><\/pre>\n<\/li>\n<li><strong>\u8fd0\u884c\u6587\u6863\u751f\u6210<\/strong><br \/>\n\u5728 Web \u754c\u9762\u4e2d\uff0c\u8f93\u5165\u4ee3\u7801\u5e93\u8def\u5f84\uff0c\u9009\u62e9\u751f\u6210\u8bbe\u7f6e\uff08\u4f8b\u5982\u6587\u6863\u98ce\u683c\u3001\u8be6\u7ec6\u7a0b\u5ea6\uff09\uff0c\u7136\u540e\u70b9\u51fb\u201c\u5f00\u59cb\u751f\u6210\u201d\u3002DocAgent \u4f1a\u81ea\u52a8\u5206\u6790\u4ee3\u7801\u7ed3\u6784\uff0c\u751f\u6210 docstrings \u5e76\u4fdd\u5b58\u5230\u539f\u4ee3\u7801\u6587\u4ef6\u4e2d\u3002\u547d\u4ee4\u884c\u7528\u6237\u53ef\u8fd0\u884c\uff1a<\/p>\n<pre><code>python run_doc_generation.py --repo_path \/path\/to\/repo\r\n<\/code><\/pre>\n<\/li>\n<li><strong>\u8bc4\u4f30\u6587\u6863\u8d28\u91cf<\/strong><br \/>\nDocAgent \u63d0\u4f9b\u72ec\u7acb\u7684\u6587\u6863\u8d28\u91cf\u8bc4\u4f30\u5de5\u5177\u3002\u8fd0\u884c\u4ee5\u4e0b\u547d\u4ee4\u542f\u52a8\u8bc4\u4f30 Web \u754c\u9762\uff1a<\/p>\n<pre><code>python run_evaluation_ui.py --host 0.0.0.0 --port 5001\r\n<\/code><\/pre>\n<p>\u8bbf\u95ee\u00a0<code>http:\/\/localhost:5001<\/code>\uff0c\u4e0a\u4f20\u751f\u6210\u7684\u6587\u6863\u6216\u4ee3\u7801\u5e93\uff0c\u5de5\u5177\u4f1a\u57fa\u4e8e\u62bd\u8c61\u8bed\u6cd5\u6811\uff08AST\uff09\u5206\u6790\u6587\u6863\u7684\u5b8c\u6574\u6027\u548c\u51c6\u786e\u6027\u3002<\/li>\n<\/ol>\n<h3>\u7279\u8272\u529f\u80fd\u64cd\u4f5c<\/h3>\n<ul>\n<li><strong>\u591a\u667a\u80fd\u4f53\u534f\u4f5c<\/strong><br \/>\nDocAgent \u4f7f\u7528\u591a\u4e2a\u667a\u80fd\u4f53\uff08\u5982\u5206\u6790\u4f9d\u8d56\u3001\u751f\u6210\u6587\u6863\u3001\u9a8c\u8bc1\u8d28\u91cf\uff09\u534f\u540c\u5de5\u4f5c\u3002\u7528\u6237\u65e0\u9700\u624b\u52a8\u5e72\u9884\uff0c\u7cfb\u7edf\u4f1a\u81ea\u52a8\u5206\u914d\u4efb\u52a1\uff0c\u786e\u4fdd\u6587\u6863\u8986\u76d6\u4ee3\u7801\u7684\u6bcf\u4e2a\u90e8\u5206\u3002<\/li>\n<li><strong>\u5c42\u6b21\u5316\u4ee3\u7801\u5206\u6790<\/strong><br \/>\n\u7cfb\u7edf\u4f18\u5148\u5904\u7406\u4f9d\u8d56\u8f83\u5c11\u7684\u4ee3\u7801\u6587\u4ef6\uff0c\u9010\u5c42\u6784\u5efa\u4e0a\u4e0b\u6587\u3002\u8fd9\u79cd\u65b9\u6cd5\u786e\u4fdd\u751f\u6210\u7684\u6587\u6863\u51c6\u786e\u53cd\u6620\u4ee3\u7801\u903b\u8f91\u3002\u4f8b\u5982\uff0c\u5de5\u5177\u4f1a\u5148\u4e3a\u5de5\u5177\u51fd\u6570\u751f\u6210\u6587\u6863\uff0c\u518d\u4e3a\u8c03\u7528\u8fd9\u4e9b\u51fd\u6570\u7684\u9ad8\u7ea7\u6a21\u5757\u751f\u6210\u6587\u6863\u3002<\/li>\n<li><strong>Web \u754c\u9762\u5b9e\u65f6\u76d1\u63a7<\/strong><br \/>\nWeb \u754c\u9762\u663e\u793a\u751f\u6210\u8fdb\u5ea6\u3001\u9519\u8bef\u65e5\u5fd7\u548c\u6587\u6863\u9884\u89c8\u3002\u7528\u6237\u53ef\u968f\u65f6\u6682\u505c\u6216\u8c03\u6574\u751f\u6210\u53c2\u6570\uff0c\u9002\u5408\u5904\u7406\u5927\u578b\u4ee3\u7801\u5e93\u3002<\/li>\n<\/ul>\n<h3>\u6ce8\u610f\u4e8b\u9879<\/h3>\n<ul>\n<li>\u786e\u4fdd\u00a0<code>agent_config.yaml<\/code>\u00a0\u914d\u7f6e\u6b63\u786e\uff0c\u5426\u5219\u53ef\u80fd\u5bfc\u81f4\u751f\u6210\u5931\u8d25\u3002<\/li>\n<li>\u5bf9\u4e8e\u5927\u578b\u4ee3\u7801\u5e93\uff0c\u5efa\u8bae\u5206\u6a21\u5757\u8fd0\u884c\u4ee5\u4f18\u5316\u6027\u80fd\u3002<\/li>\n<li>\u5982\u679c\u4f7f\u7528\u672c\u5730 LLM\uff0c\u68c0\u67e5\u786c\u4ef6\u662f\u5426\u6ee1\u8db3\u6a21\u578b\u8fd0\u884c\u9700\u6c42\uff08\u5982 GPU \u5185\u5b58\uff09\u3002<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h2>\u5e94\u7528\u573a\u666f<\/h2>\n<ol>\n<li><strong>\u63d0\u5347\u56e2\u961f\u4ee3\u7801\u53ef\u7ef4\u62a4\u6027<\/strong><br \/>\n\u5f00\u53d1\u56e2\u961f\u4f7f\u7528 DocAgent \u4e3a\u73b0\u6709 Python \u9879\u76ee\u751f\u6210\u6587\u6863\u6ce8\u91ca\uff0c\u51cf\u5c11\u624b\u52a8\u7f16\u5199\u6587\u6863\u7684\u65f6\u95f4\u3002\u751f\u6210\u7684\u6587\u6863\u5305\u542b\u51fd\u6570\u7528\u9014\u3001\u53c2\u6570\u8bf4\u660e\u548c\u8fd4\u56de\u503c\u63cf\u8ff0\uff0c\u5e2e\u52a9\u65b0\u6210\u5458\u5feb\u901f\u7406\u89e3\u4ee3\u7801\u3002<\/li>\n<li><strong>\u5f00\u6e90\u9879\u76ee\u6587\u6863\u6807\u51c6\u5316<\/strong><br \/>\n\u5f00\u6e90\u9879\u76ee\u7ef4\u62a4\u8005\u5229\u7528 DocAgent \u4e3a\u4ee3\u7801\u5e93\u751f\u6210\u4e00\u81f4\u7684\u6587\u6863\u6ce8\u91ca\uff0c\u63d0\u5347\u9879\u76ee\u4e13\u4e1a\u6027\u3002\u8bc4\u4f30\u5de5\u5177\u53ef\u68c0\u67e5\u6587\u6863\u5b8c\u6574\u6027\uff0c\u786e\u4fdd\u7b26\u5408\u793e\u533a\u6807\u51c6\u3002<\/li>\n<li><strong>\u4e2a\u4eba\u5f00\u53d1\u8005\u6548\u7387\u63d0\u5347<\/strong><br \/>\n\u72ec\u7acb\u5f00\u53d1\u8005\u4f7f\u7528 DocAgent \u5feb\u901f\u4e3a\u4e2a\u4eba\u9879\u76ee\u751f\u6210\u6587\u6863\uff0c\u4e13\u6ce8\u4e8e\u7f16\u7801\u800c\u975e\u6587\u6863\u7f16\u5199\u3002Web \u754c\u9762\u7b80\u5316\u64cd\u4f5c\uff0c\u9002\u5408\u975e\u4e13\u4e1a\u7528\u6237\u3002<\/li>\n<\/ol>\n<p>&nbsp;<\/p>\n<h2>QA<\/h2>\n<ol>\n<li><strong>DocAgent \u652f\u6301\u54ea\u4e9b\u7f16\u7a0b\u8bed\u8a00\uff1f<\/strong><br \/>\n\u76ee\u524d DocAgent \u4ec5\u652f\u6301 Python \u4ee3\u7801\u5e93\u7684\u6587\u6863\u751f\u6210\uff0c\u672a\u6765\u53ef\u80fd\u6269\u5c55\u5230\u5176\u4ed6\u8bed\u8a00\u3002<\/li>\n<li><strong>\u662f\u5426\u9700\u8981\u8054\u7f51\u8fd0\u884c\uff1f<\/strong><br \/>\n\u5982\u679c\u4f7f\u7528\u4e91\u7aef LLM\uff0c\u9700\u8981\u8054\u7f51\u3002\u5982\u679c\u914d\u7f6e\u672c\u5730 LLM\uff0c\u53ef\u4ee5\u79bb\u7ebf\u8fd0\u884c\u3002<\/li>\n<li><strong>\u5982\u4f55\u5904\u7406\u751f\u6210\u6587\u6863\u4e2d\u7684\u9519\u8bef\uff1f<\/strong><br \/>\n\u4f7f\u7528\u6587\u6863\u8d28\u91cf\u8bc4\u4f30\u5de5\u5177\u68c0\u67e5\u6587\u6863\u5b8c\u6574\u6027\uff0c\u624b\u52a8\u7f16\u8f91\u00a0<code>agent_config.yaml<\/code>\u00a0\u8c03\u6574\u751f\u6210\u53c2\u6570\uff0c\u6216\u5728 GitHub \u63d0\u4ea4 issue \u5bfb\u6c42\u793e\u533a\u5e2e\u52a9\u3002<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>DocAgent \u662f\u4e00\u4e2a\u7531 Meta AI \u5f00\u53d1\u3001\u5f00\u6e90\u7684 Python \u4ee3\u7801\u6587\u6863\u751f\u6210\u5de5\u5177\u3002\u5b83\u901a\u8fc7\u591a\u667a\u80fd\u4f53\u534f\u4f5c\u548c\u5c42\u6b21\u5316\u4ee3\u7801\u5206\u6790\uff0c\u81ea\u52a8\u4e3a Python \u4ee3\u7801\u5e93\u751f\u6210\u9ad8\u8d28\u91cf\u3001\u4e0a\u4e0b\u6587\u611f\u77e5\u7684\u6587\u6863\u6ce8\u91ca\uff08docstrings\uff09\u3002DocAgent \u89e3\u51b3\u4e86\u4f20\u7edf&#8230;<\/p>\n","protected":false},"author":1,"featured_media":62291,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[20],"tags":[230],"class_list":["post-30636","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tool","tag-aikaiyuanxiangmu"],"_links":{"self":[{"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/posts\/30636","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/comments?post=30636"}],"version-history":[{"count":0,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/posts\/30636\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/media\/62291"}],"wp:attachment":[{"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/media?parent=30636"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/categories?post=30636"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/tags?post=30636"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}