Cursor rule

1---
2description: "Agent configuration patterns and examples for Compozy agents"
3globs:
4  - "**/agents/*.yaml"
5  - "**/agent.yaml"
6alwaysApply: false
7---
8# Compozy Agent Configuration Examples
9 
10<configuration_overview type="agent_config">
11Agent configuration defines AI agents with instructions, tools, actions, and MCP integrations for workflow execution.
12</configuration_overview>
13 
14## Basic Agent Configuration
15 
16<agent_config_pattern type="basic_agent">
17```yaml
18resource: agent
19id: tourist_guide
20description: A helpful tourist guide assistant
21version: 0.1.0
22
23config:
24  provider: groq
25  model: llama-3.3-70b-versatile
26  api_key: "{{ .env.GROQ_API_KEY }}"
27
28instructions: |
29  You are a helpful tourist guide assistant specialized in {{ .workflow.input.city }}
30  Your capabilities:
31  - Provide thoughtful recommendations for activities
32  - Suggest appropriate clothing based on weather
33  Always respond in valid JSON format when json_mode is enabled.
34
35tools:
36  - $ref: local::tools.#(id=="weather_tool")
37
38actions:
39  - id: get_weather
40    prompt: |
41      What is the current weather in {{ .workflow.input.city }}?
42
43  - id: suggest_activities
44    json_mode: true
45    prompt: |
46      Given the current conditions: {{ .tasks.weather.output | toJson }}
47      Suggest appropriate activities for these weather conditions
48    output:
49      type: object
50      properties:
51        activities:
52          type: array
53          items:
54            type: string
55      required:
56        - activities
57```
58</agent_config_pattern>
59 
60## Agent with MCP Integration
61 
62<agent_config_pattern type="agent_with_mcp">
63```yaml
64resource: agent
65id: file_reader
66description: An agent that uses MCP tools to read and list files
67version: 0.1.0
68
69config:
70  provider: groq
71  model: llama-3.3-70b-versatile
72  api_key: "{{ .env.GROQ_API_KEY }}"
73
74instructions: |
75  You are a file management assistant that uses MCP tools.
76  Use MCP tools to check what files exist and read contents when needed.
77
78mcps:
79  - id: file_server
80    transport: stdio
81    command: npx
82    args:
83      - -y
84      - "@modelcontextprotocol/server-filesystem"
85      - "./"
86    proto: "2025-03-26"
87    start_timeout: 15s
88
89actions:
90  - id: list_saved_files
91    prompt: |
92      Use MCP tools to list files in the current directory.
93      Look for results.json and results.txt files.
94      Use the read_directory MCP tool to list contents.
95```
96</agent_config_pattern>
97