Skip to main content

Documentation Index

Fetch the complete documentation index at: https://honeydew.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Agents are the entry point for AI and deep analysis in Honeydew. Each agent defines which domain the AI can access and which context it loads into analysis sessions.

​
Creating an Agent

Agents can be created in a few ways:
  • Honeydew Studio — use the agent builder in the UI
  • Git repository — commit a file to the ai/agents/ directory in your workspace
  • Coding agent — use a coding agent connected via MCP to create and manage agents (see MCP agent tools)
---
type: agent
name: growth-analyst
display_name: Growth Analysis Specialist
description: Analyzes user growth, acquisition, and activation metrics
welcome_message: |
  Ask me about user growth, acquisition, and activation.
sample_questions: []  # auto-generated in Honeydew Studio if empty
domain: sales
context:
  - general/*
  - skills/analysis/*
  - knowledge/marketing/*
  - skills/reporting/growth-dashboard
owner: growth-team
---

This agent specializes in growth analysis for the sales domain.
Use it to investigate user acquisition funnels, activation rates,
and cohort-level retention trends.
The Markdown body after the frontmatter is the agent’s AI context. It is injected into the prompt before every analysis session, giving the AI additional guidance specific to this agent — its purpose, analytical focus, or any constraints on how it should respond.

​
Context References

The context field accepts context item names and glob patterns.
PatternMatches
skills/analysis/funnel-analysisExact item by full name
skills/analysis/*All items directly under skills/analysis/
knowledge/**All items with the knowledge/ prefix
*All context items
Items matching multiple patterns are deduplicated automatically.

​
Access Control

Users are granted access to specific agents. Access to an agent grants access to the underlying domain and all referenced context items. The same domain can be exposed through multiple agents with different context sets — for example, a finance-analyst agent and a sales-analyst agent can both access the revenue domain while loading different context.

​
YAML Schema

Each agent is defined by a Markdown file with YAML frontmatter in Git. 
type: agent                           # required
name: <name>                          # required
display_name: <display name>          # optional
description: <description>           # optional
welcome_message: |                    # optional
  <welcome message>
sample_questions:                     # optional; auto-generated in Honeydew Studio if empty
  - <question>
domain: <domain name>                 # required
context:                              # optional
  - <context item name or glob pattern>
owner: <owner>                        # optional
model: <model id>                     # optional
Fields:
  • type: Required. Must be agent
  • name: Required. Unique identifier for the agent within the workspace
  • display_name: Human-readable name shown in the UI
  • description: What this agent does
  • welcome_message: Text shown to users at the start of a session
  • sample_questions: Suggested questions; auto-generated in Honeydew Studio if empty
  • domain: Required. The domain the agent has access to
  • context: List of context item names or glob patterns (see Context References)
  • owner: Team or user responsible for this agent
  • model: Overrides the default LLM for deep analysis sessions started by this agent. Accepts a Honeydew model ID or a provider-specific model ID (e.g., claude-sonnet-4-6). When not set, the workspace default model is used. The model must be supported by the workspace’s LLM provider. Supported Honeydew model IDs:
    Model IDDisplay name
    CLAUDE_4_5_SONNETClaude Sonnet 4.5
    CLAUDE_4_5_OPUSClaude Opus 4.5
    CLAUDE_4_6_SONNETClaude Sonnet 4.6
    CLAUDE_4_6_OPUSClaude Opus 4.6
    OPEN_AI_GPT_5_2OpenAI GPT-5.2
    OPEN_AI_GPT_5_3OpenAI GPT-5.3
    OPEN_AI_GPT_5_4OpenAI GPT-5.4
    OPEN_AI_GPT_5_5OpenAI GPT-5.5
    GEMINI_3_1_PROGemini 3.1 Pro