GitHub_Trending/ad/adk-samples提示工程指南：prompt.py 设计与优化技巧-CSDN博客

安宇雨 - 随手采集
2025-10-26 10:43:50
随手采集
0000-未整理-等待研究

GitHub_Trending/ad/adk-samples提示工程指南：prompt.py 设计与优化技巧

【免费下载链接】adk-samples A collection of sample agents built with Agent Development (ADK) 项目地址: https://gitcode.com/GitHub_Trending/ad/adk-samples

在基于Agent Development Kit（ADK）构建智能体时，提示工程（Prompt Engineering）是决定AI行为质量的核心环节。本文将通过分析adk-samples项目中prompt.py文件的设计模式，系统总结提示模板的结构化设计、多轮对话管理和领域适配技巧，帮助开发者快速掌握高质量提示的构建方法。

提示工程基础：文件结构与核心作用

adk-samples项目中，prompt.py文件广泛分布于各智能体模块，承担着定义AI角色、行为流程和输出格式的关键作用。典型路径包括：

学术研究智能体：python/agents/academic-research/academic_research/prompt.py
金融顾问智能体：python/agents/financial-advisor/financial_advisor/prompt.py
品牌搜索优化智能体：python/agents/brand-search-optimization/brand_search_optimization/prompt.py

这些文件通过声明式字符串定义AI行为，使非技术人员也能通过修改自然语言描述调整智能体能力，实现"代码与配置分离"的工程最佳实践。

结构化设计：三段式提示模板

角色定义（Role）

清晰的角色定位是提示设计的起点。金融顾问智能体通过精确的角色描述建立专业权威性：

Role: Act as a specialized financial advisory assistant.Your primary goal is to guide users through a structured process to receive financial advice by orchestrating a series of expert subagents.You will help them analyze a market ticker, develop trading strategies, define execution plans, and evaluate the overall risk.

工作流程（Workflow）

学术研究智能体展示了复杂流程的结构化表达方法，通过编号步骤和明确动作指令实现可预测的多阶段行为：

Workflow:1. Initiation:   - Greet the user   - Ask for seminal paper PDF2. Seminal Paper Analysis:   - Process paper and extract structured information   - Present under standard headings (Abstract, Summary, Key Innovations)3. Find Recent Citing Papers:   - Invoke academic_websearch tool   - Input: Seminal paper identifiers4. Suggest Future Research Directions:   - Use academic_newresearch tool   - Input: Paper analysis + citing papers

输出格式（Output Format）

标准化输出是提示工程的关键实践。学术研究智能体通过强制格式约束确保结果一致性：

Present the extracted information clearly under the following distinct headings:- Seminal Paper: [Display Title, Primary Author(s), Publication Year]- Authors: [List all authors with affiliations]- Abstract: [Full abstract text]- Summary: [5-10 sentence narrative]- Key Topics/Keywords: [Bulleted list]- Key Innovations: [Up to 5 bullet points]- References Cited: [Standard citation format]

高级技巧：动态变量与工具调用

状态管理

金融顾问智能体展示了如何通过状态键（state key）在多轮对话中传递上下文：

Input:- The market_data_analysis_output (from state key)- The user-selected risk attitude- The user-selected investment period

工具集成

学术研究智能体通过明确的动作指令实现工具调用：

Action: Invoke the academic_websearch agent/tool.Input to Tool: Provide necessary identifiers for the seminal paper.Expected Output from Tool: A list of recent academic papers citing the seminal work.