Dropstone Docs

ஏஜென்ட்கள்

சிறப்பு ஏஜென்ட்களை கட்டமைக்கவும் மற்றும் பயன்படுத்தவும்.

ஏஜென்ட்கள் என்பவை சிறப்பு AI உதவிகளாகும், அவை குறிப்பிட்ட பணிகள் மற்றும் பணிப்பாய்களுக்கு கட்டமைக்கப்படலாம். அவை தனிப்பயன் உத்தரவுகள், மாதிரிகள் மற்றும் கருவி அணுகலுடன் கவனம் செலுத்திய கருவிகளை உருவாக்க உங்களை அனுமதிக்கின்றன.

குறிப்பு:

குறியீட்டை பகுப்பாய்வு செய்ய மற்றும் பரிந்துரைகளை மதிப்பாய்வு செய்ய திட்ட ஏஜென்ட்டைப் பயன்படுத்தவும், குறியீட்டில் எந்த மாற்றமும் செய்யாமல்.

ஒரு அமர்வின் போது ஏஜென்ட்களுக்கு இடையில் மாற்றலாம் அல்லது @ குறிப்பைக் கொண்டு அவற்றை அழைக்கலாம்.

வகைகள்

Dropstone இல் இரண்டு வகையான ஏஜென்ட்கள் உள்ளன; முதன்மை ஏஜென்ட்கள் மற்றும் துணை ஏஜென்ட்கள்.

முதன்மை ஏஜென்ட்கள்

முதன்மை ஏஜென்ட்கள் நீங்கள் நேரடியாக தொடர்பு கொள்ளும் முக்கிய உதவிகளாகும். Tab விசையைப் பயன்படுத்தி அல்லது உங்கள் கட்டமைக்கப்பட்ட switch_agent விசைப்பிணைப்பைப் பயன்படுத்தி அவற்றுக்கு இடையில் சுழலலாம். இந்த ஏஜென்ட்கள் உங்கள் முக்கிய உரையாடலைக் கையாளுகின்றன. கருவி அணுகல் அনுமதிகளின் மூலம் கட்டமைக்கப்படுகிறது: எடுத்துக்காட்டாக, Build இல் அனைத்து கருவிகளும் இயக்கப்பட்டுள்ளன, அதே சமயம் Plan வரையறுக்கப்பட்டுள்ளது.

குறிப்பு:

ஒரு அமர்வின் போது முதன்மை ஏஜென்ட்களுக்கு இடையில் மாற்ற Tab விசையைப் பயன்படுத்தலாம்.

Dropstone இல் இரண்டு உள்ளமைக்கப்பட்ட முதன்மை ஏஜென்ட்கள் உள்ளன, Build மற்றும் Plan. இவற்றை கீழே பார்ப்போம்.

துணை ஏஜென்ட்கள்

துணை ஏஜென்ட்கள் சிறப்பு உதவிகளாகும், அவை முதன்மை ஏஜென்ட்கள் குறிப்பிட்ட பணிகளுக்கு அழைக்கலாம். உங்கள் செய்திகளில் @ குறிப்பிடுவதன் மூலம் நீங்கள் அவற்றை கைமுறையாக அழைக்கலாம்.

Dropstone இல் இரண்டு உள்ளமைக்கப்பட்ட துணை ஏஜென்ட்கள் உள்ளன, General மற்றும் Explore. இவற்றை கீழே பார்ப்போம்.

உள்ளமைக்கப்பட்ட

Dropstone இல் இரண்டு உள்ளமைக்கப்பட்ட முதன்மை ஏஜென்ட்கள் மற்றும் இரண்டு உள்ளமைக்கப்பட்ட துணை ஏஜென்ட்கள் உள்ளன.

Build ஐப் பயன்படுத்தவும்

Mode: primary

Build என்பது இயல்புநிலை முதன்மை ஏஜென்ட் ஆகும், அனைத்து கருவிகளும் இயக்கப்பட்டுள்ளன. இது வளர்ச்சி பணிக்கான நிலையான ஏஜென்ட் ஆகும், அங்கு உங்களுக்கு கோப்பு செயல்பாடுகள் மற்றும் கணினி கட்டளைகளுக்கு முழு அணுகல் தேவை.

Plan ஐப் பயன்படுத்தவும்

Mode: primary

திட்டமிடல் மற்றும் பகுப்பாய்வுக்கு வடிவமைக்கப்பட்ட வரையறுக்கப்பட்ட ஏஜென்ட். உங்களுக்கு அதிக கட்டுப்பாடு மற்றும் நிர்ணயிக்கப்படாத மாற்றங்களைத் தடுக்க அனுமதி அமைப்பைப் பயன்படுத்துகிறோம். இயல்புநிலையாக, பின்வருவனவெல்லாம் ask ஆக அமைக்கப்பட்டுள்ளன:

  • file edits: அனைத்து எழுதுதல், திருத்தங்கள் மற்றும் திருத்தங்கள்
  • bash: அனைத்து bash கட்டளைகள்

இந்த ஏஜென்ட் LLM குறியீட்டை பகுப்பாய்வு செய்ய, மாற்றங்களை பரிந்துரைக்க அல்லது உங்கள் கோডுபேஸில் உண்மையான மாற்றங்கள் செய்யாமல் திட்டங்களை உருவாக்க விரும்பும் போது பயனுள்ளதாக இருக்கிறது.

General ஐப் பயன்படுத்தவும்

Mode: subagent

சிக்கலான கேள்விகளை ஆராய்வதற்கும் பல-படி பணிகளை செயல்படுத்துவதற்கும் ஒரு பொது-நோக்க ஏஜென்ட். முழு கருவி அணுகல் உள்ளது (todo தவிர), எனவே தேவைப்படும் போது கோப்பு மாற்றங்களைச் செய்யலாம். பல அலகுகளின் பணிகளை இணையாக இயக்க இதைப் பயன்படுத்தவும்.

Explore ஐப் பயன்படுத்தவும்

Mode: subagent

கோடுபேஸ்களை ஆராய்வதற்கான வேகமான, படிக்க-மட்டுமே ஏஜென்ட். கோப்புகளை மாற்ற முடியாது. வடிவங்களால் கோப்புகளை விரைவாகக் கண்டறிய, குறியீட்டில் முக்கிய சொற்களைத் தேட அல்லது கோடுபேஸ் பற்றிய கேள்விகளுக்கு பதிலளிக்க வேண்டிய போது இதைப் பயன்படுத்தவும்.

Compaction ஐப் பயன்படுத்தவும்

Mode: primary

நீண்ட சூழலை சிறிய சுருக்கமாக சுருக்கும் மறைக்கப்பட்ட கணினி ஏஜென்ட். இது தேவைப்படும் போது தானாக இயங்குகிறது மற்றும் UI இல் தேர்ந்தெடுக்க முடியாது.

Title ஐப் பயன்படுத்தவும்

Mode: primary

குறுகிய அமர்வு தலைப்புகளை உருவாக்கும் மறைக்கப்பட்ட கணினி ஏஜென்ட். இது தானாக இயங்குகிறது மற்றும் UI இல் தேர்ந்தெடுக்க முடியாது.

Summary ஐப் பயன்படுத்தவும்

Mode: primary

அமர்வு சுருக்கங்களை உருவாக்கும் மறைக்கப்பட்ட கணினி ஏஜென்ட். இது தானாக இயங்குகிறது மற்றும் UI இல் தேர்ந்தெடுக்க முடியாது.

பயன்பாடு

  1. முதன்மை ஏஜென்ட்களுக்கு, ஒரு அமர்வின் போது அவற்றுக்கு இடையில் சுழலக Tab விசையைப் பயன்படுத்தவும். உங்கள் கட்டமைக்கப்பட்ட switch_agent விசைப்பிணைப்பையும் பயன்படுத்தலாம்.

  2. துணை ஏஜென்ட்களை அழைக்கலாம்:

    • தானாக முதன்மை ஏஜென்ட்களால் அவற்றின் விளக்கங்களின் அடிப்படையில் சிறப்பு பணிகளுக்கு.

    • உங்கள் செய்திகளில் @ குறிப்பிடுவதன் மூலம் கைமுறையாக. எடுத்துக்காட்டாக.

      @general help me search for this function

  3. அமர்வுகளுக்கு இடையில் செல்லலாம்: துணை ஏஜென்ட்கள் குழந்தை அமர்வுகளை உருவாக்கும் போது, பெற்றோர் அமர்விலிருந்து முதல் குழந்தை அமர்வுக்குள் நுழைய session_child_first (இயல்புநிலை: <Leader>+Down) ஐப் பயன்படுத்தவும்.

  4. ஒரு குழந்தை அமர்வில் இருந்தால், பயன்படுத்தவும்:

    • session_child_cycle (இயல்புநிலை: Right) அடுத்த குழந்தை அமர்வுக்குச் செல்ல
    • session_child_cycle_reverse (இயல்புநிலை: Left) முந்தைய குழந்தை அமர்வுக்குச் செல்ல
    • session_parent (இயல்புநிலை: Up) பெற்றோர் அமர்வுக்குத் திரும்ப

    இது முக்கிய உரையாடல் மற்றும் சிறப்பு துணை ஏஜென்ட் பணிக்கு இடையில் மாற்ற உங்களை அனுமதிக்கிறது.

கட்டமைக்கவும்

உள்ளமைக்கப்பட்ட ஏஜென்ட்களை தனிப்பயனாக்கலாம் அல்லது கட்டமைப்பின் மூலம் உங்கள் சொந்தமாக உருவாக்கலாம். ஏஜென்ட்களை இரண்டு வழிகளில் கட்டமைக்கலாம்:

JSON

உங்கள் dropstone.json கட்டமைப்பு கோப்பில் ஏஜென்ட்களை கட்டமைக்கவும்:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "agent": {
    "build": {
      "mode": "primary",
      "model": "dropstone/dropstone-pro",
      "prompt": "{file:./prompts/build.txt}",
      "permission": {
        "edit": "allow",
        "bash": "allow"
      }
    },
    "plan": {
      "mode": "primary",
      "model": "dropstone/dropstone-fast",
      "permission": {
        "edit": "deny",
        "bash": "deny"
      }
    },
    "code-reviewer": {
      "description": "Reviews code for best practices and potential issues",
      "mode": "subagent",
      "model": "dropstone/dropstone-pro",
      "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
      "permission": {
        "edit": "deny"
      }
    }
  }
}

Markdown

Markdown கோப்புகளைப் பயன்படுத்தி ஏஜென்ட்களை வரையறுக்கலாம். அவற்றை இங்கே வைக்கவும்:

  • Global: ~/.config/dropstone/agents/
  • Per-project: .dropstone/agents/
---
description: Reviews code for quality and best practices
mode: subagent
model: dropstone/dropstone-pro
temperature: 0.1
permission:
  edit: deny
  bash: deny
---

You are in code review mode. Focus on:

- Code quality and best practices
- Potential bugs and edge cases
- Performance implications
- Security considerations

Provide constructive feedback without making direct changes.

Markdown கோப்பின் பெயர் ஏஜென்ட் பெயரை ஆகிறது. எடுத்துக்காட்டாக, review.md ஒரு review ஏஜென்ட்டை உருவாக்குகிறது.

விருப்பங்கள்

இந்த கட்டமைப்பு விருப்பங்களை விரிவாகப் பார்ப்போம்.

விளக்கம்

ஏஜென்ட் என்ன செய்கிறது மற்றும் எப்போது பயன்படுத்த வேண்டும் என்பதற்கான சுருக்கமான விளக்கத்தை வழங்க description விருப்பத்தைப் பயன்படுத்தவும்.

{
  "agent": {
    "review": {
      "description": "Reviews code for best practices and potential issues"
    }
  }
}

இது தேவையான கட்டமைப்பு விருப்பம் ஆகும்.

வெப்பநிலை

temperature கட்டமைப்பைக் கொண்டு LLM இன் பதிலின் சீரற்ற தன்மை மற்றும் படைப்பாற்றலைக் கட்டுப்படுத்தவும்.

குறைந்த மதிப்புகள் பதிலை மேலும் கவனம் செலுத்தி உறுதியாக்குகிறது, அதே சமயம் அதிக மதிப்புகள் படைப்பாற்றல் மற்றும் மாறுபாட்டை அதிகரிக்கிறது.

{
  "agent": {
    "plan": {
      "temperature": 0.1
    },
    "creative": {
      "temperature": 0.8
    }
  }
}

வெப்பநிலை மதிப்புகள் பொதுவாக 0.0 முதல் 1.0 வரை இருக்கும்:

  • 0.0-0.2: மிகவும் கவனம் செலுத்திய மற்றும் உறுதியான பதிலுகள், குறியீட்டு பகுப்பாய்வு மற்றும் திட்டமிடலுக்கு சிறந்தது
  • 0.3-0.5: சில படைப்பாற்றல் கொண்ட சமநிலையான பதிலுகள், பொது வளர்ச்சி பணிகளுக்கு நல்லது
  • 0.6-1.0: மேலும் படைப்பாற்றல் மற்றும் மாறுபட்ட பதிலுகள், மூளைச்சலவை மற்றும் ஆய்வுக்கு பயனுள்ளது
{
  "agent": {
    "analyze": {
      "temperature": 0.1,
      "prompt": "{file:./prompts/analysis.txt}"
    },
    "build": {
      "temperature": 0.3
    },
    "brainstorm": {
      "temperature": 0.7,
      "prompt": "{file:./prompts/creative.txt}"
    }
  }
}

வெப்பநிலை குறிப்பிடப்படாவிட்டால், Dropstone ஒவ்வொரு அடுக்குக்கும் சரிசெய்யப்பட்ட நியாயமான இயல்புநிலையைப் பயன்படுத்துகிறது.

அதிகபட்ச படிகள்

ஒரு ஏஜென்ட் செய்யக்கூடிய அதிகபட்ச ஏஜென்ட் மறு செயல்பாடுகளின் எண்ணிக்கையைக் கட்டுப்படுத்தவும், அதன் பிறகு உரை-மட்டுமே பதிலளிக்க கட்டாயப்படுத்தவும். செலவுகளைக் கட்டுப்படுத்த விரும்பும் ব்যবহারকாரிகளை ஏஜென்ட் செயல்களில் வரம்பு அமைக்க அனுமதிக்கிறது.

இது அமைக்கப்படாவிட்டால், ஏஜென்ட் மாதிரி நிறுத்த தேர்வு செய்யும் வரை அல்லது ব்যবহারকாரி அமர்வை நிறுத்தும் வரை மறு செயல்பாடு செய்யும்.

{
  "agent": {
    "quick-thinker": {
      "description": "Fast reasoning with limited iterations",
      "prompt": "You are a quick thinker. Solve problems with minimal steps.",
      "steps": 5
    }
  }
}

வரம்பு அடையும் போது, ஏஜென்ட் ஒரு சிறப்பு கணினி உத்தரவு பெறுகிறது, அதன் பணியின் சுருக்கத்தை மற்றும் பரிந்துரைக்கப்பட்ட மீதமுள்ள பணிகளை பதிலளிக்க அறிவுறுத்துகிறது.

弃用:

பழைய maxSteps புலம்弃用 ஆகிறது. அதற்கு பதிலாக steps ஐப் பயன்படுத்தவும்.

முடக்கவும்

ஏஜென்ட்டை முடக்க true ஆக அமைக்கவும்.

{
  "agent": {
    "review": {
      "disable": true
    }
  }
}

உத்தரவு

prompt கட்டமைப்பைக் கொண்டு இந்த ஏஜென்ட்டுக்கு ஒரு தனிப்பயன் கணினி உத்தரவு கோப்பைக் குறிப்பிடவும். உத்தரவு கோப்பு ஏஜென்ட்டின் நோக்கத்துக்கு குறிப்பிட்ட வழிமுறைகளைக் கொண்டிருக்க வேண்டும்.

{
  "agent": {
    "review": {
      "prompt": "{file:./prompts/code-review.txt}"
    }
  }
}

இந்த பாதை கட்டமைப்பு கோப்பு அமைந்துள்ள இடத்துடன் தொடர்புடையது. எனவே இது உலகளாவிய Dropstone கட்டமைப்பு மற்றும் திட்ட-குறிப்பிட்ட கட்டமைப்பு இரண்டுக்கும் வேலை செய்கிறது.

மாதிரி

இந்த ஏஜென்ட்டுக்கான மாதிரியை மேலெழுத model கட்டமைப்பைப் பயன்படுத்தவும். வெவ்வேறு பணிகளுக்கு অনুকূলமான வெவ்வேறு மாதிரிகளைப் பயன்படுத்த பயனுள்ளது. எடுத்துக்காட்டாக, திட்டமிடலுக்கான வேகமான மாதிரி, செயல்படுத்தலுக்கான மேலும் திறமையான மாதிரி.

குறிப்பு:

நீங்கள் ஒரு மாதிரியைக் குறிப்பிடாவிட்டால், முதன்மை ஏஜென்ட்கள் உலகளாவிய கட்டமைக்கப்பட்ட மாதிரியைப் பயன்படுத்துகின்றன, அதே சமயம் துணை ஏஜென்ட்கள் அவற்றை அழைத்த முதன்மை ஏஜென்ட்டின் மாதிரியை பெறுகின்றன.

{
  "agent": {
    "plan": {
      "model": "dropstone/dropstone-fast"
    }
  }
}

மாதிரி ID dropstone/<tier> வடிவத்தைப் பயன்படுத்துகிறது. dropstone/dropstone-fast, dropstone/dropstone-pro அல்லது dropstone/dropstone-heavy ஐப் பயன்படுத்தவும்.

கருவிகள் (弃用)

tools 弃用 ஆகிறது. புதிய கட்டமைப்புகள், புதுப்பிப்புகள் மற்றும் மேலும் நுண்ணிய கட்டுப்பாட்டுக்கு ஏஜென்ட்டின் permission புலத்தை விரும்பவும்.

இந்த ஏஜென்ட்டில் எந்த கருவிகள் கிடைக்கின்றன என்பதைக் கட்டுப்படுத்த உங்களை அனுமதிக்கிறது. true அல்லது false ஆக அமைத்து குறிப்பிட்ட கருவிகளை இயக்கலாம் அல்லது முடக்கலாம். ஒரு ஏஜென்ட்டின் tools கட்டமைப்பில், true என்பது {"*": "allow"} அனுமதிக்கு சமம் மற்றும் false என்பது {"*": "deny"} அனுமதிக்கு சமம்.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "tools": {
    "write": true,
    "bash": true
  },
  "agent": {
    "plan": {
      "tools": {
        "write": false,
        "bash": false
      }
    }
  }
}

Note:

ஏஜென்ட்-குறிப்பிட்ட கட்டமைப்பு உலகளாவிய கட்டமைப்பை மேலெழுதுகிறது.

பல கருவிகளை ஒரே நேரத்தில் கட்டுப்படுத்த பழைய tools உள்ளீடுகளில் வைல்டকார்டுகளைப் பயன்படுத்தலாம். எடுத்துக்காட்டாக, MCP சேவையகத்திலிருந்து அனைத்து கருவிகளையும் முடக்க:

{
  "$schema":
Ctrl+I