docker-agent/examples/handoff.yaml at main · docker/docker-agent · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
# Handoff Graph Diagram:
#
#   ─────>   Root Agent  <────────<─<─<──────┐
#                |                           |
#        ┌───────┼────────┐                  |
#        |                |                  |
#        ↓                ↓                  |
#   Web Search      Filesystem Search        |
#        |                |                  |
#        |        ┌───────┴───────┐          |
#        |        |               |          ↑
#        |    (if list)    (if contents)     ↑
#        ↓        |               ↓          ↑
#        ↓        ↓            Redactor      |
#        ↓        |               ↓          |
#        |        └───────┬───────┘          |
#        |                ↓                  |
#        |            Tabulator              |
#        |                ↓                  |
#        └────────┼───────┘                  |
#                 ↓                          |
#             Summarizer ──────>─>─>─────────┘
#

agents:
  root:
    model: anthropic/claude-sonnet-4-5
    description: Search coordinator that routes queries to appropriate search agents
    instruction: |
      You are a search coordinator that helps users find information.
      Based on the user's query, determine whether they need:
      - Web search: for general information, current events, or online resources
      - Filesystem search: for searching local files, directories, or file contents

      Hand off to the appropriate agent based on the query type.
      If the query is ambiguous, ask the user for clarification.
    handoffs:
      - web_search
      - filesystem_search

  web_search:
    model: openai/gpt-4o
    description: Specialized in web searching and information retrieval from the internet
    instruction: |
      You are an agent specialized in web searching and information retrieval.
      Use the DuckDuckGo search tools to find relevant information on the web.
      After gathering search results, hand off to the summarizer agent to present the findings.
    toolsets:
      - type: mcp
        ref: docker:duckduckgo
    handoffs:
      - summarizer

  filesystem_search:
    model: openai/gpt-4o
    description: Specialized in searching local filesystem, directories, and file contents
    instruction: |
      You are an agent specialized in searching the local filesystem.
      Use filesystem tools to search for files, list directories, or read file contents.

      After performing your search:
      - If the results are a list of files/directories (tabular data), you MUST call the handoff tool to hand off to the tabulator agent
      - If the results are file contents (text from reading files), you MUST call the handoff tool to hand off to the redactor agent first

      Make your decision based on what type of data you've retrieved.
    toolsets:
      - type: filesystem
    handoffs:
      - tabulator
      - redactor

  redactor:
    model: openai/gpt-4o-mini
    description: Redacts sensitive information like API keys, passwords, and secrets from file contents
    instruction: |
      You are a security-focused agent that redacts sensitive information from file contents.
      Look for and redact:
      - API keys (look for patterns like "api_key", "API_KEY", "apikey")
      - Passwords (look for "password", "passwd", "pwd")
      - Secrets (look for "secret", "SECRET", "token", "TOKEN")
      - Private keys (look for "-----BEGIN", "PRIVATE KEY")
      - Email addresses (optional, based on context)

      Replace sensitive values with "[REDACTED]" or similar placeholders.
      After redacting, you MUST call the handoff tool to hand off to the tabulator agent.
    handoffs:
      - tabulator

  tabulator:
    model: openai/gpt-4o-mini
    description: Formats data into well-structured tables for presentation
    instruction: |
      You are an agent specialized in formatting data into tables.
      Analyze the data you receive to determine if it contains tabular elements:
      - CSV/TSV data
      - Lists of items with similar structure
      - Key-value pairs that can be organized into columns
      - Other structured data, such as search results or file listings

      If the data is tabular, format it as a clear, readable markdown table.
      Use markdown table format or ASCII table formatting.

      For file listings, create columns like: Name, Type, Size, Modified
      For search results, create columns appropriate to the data.

      If the data is not tabular (e.g., plain text, source code, unstructured content),
      pass it through unchanged - your job is only to format tabular data, not to force
      non-tabular content into tables.

      IMPORTANT: After processing the data, you MUST call the handoff tool to hand off to the summarizer agent.
    handoffs:
      - summarizer

  summarizer:
    model: anthropic/claude-sonnet-4-5
    description: Presents search results and summaries in a clear, organized format
    instruction: |
      You are the final presentation agent that summarizes and presents search results.
      Take the information you receive from other agents and present it clearly to the user.

      - For all results: Provide a summary with key findings and sources
      - For results containing tables, preserve the table formatting (remove rows with annotation of more than 20 rows)
      - Always be concise and well-organized
      - Include relevant context from the search process

      You are the final agent in the workflow - present the results and complete the task,
      then you MUST call the handoff tool to hand off back to the root agent.
    handoffs:
      - root