Buďte špecifickí a popisní
Použite názov, ktorý odráža účel agenta
Príklady:
- ✅ Dobré: "Recenzent Python kódu", "Pisateľ marketingového obsahu"
- ❌ Zlé: "Agent 1", "Môj agent", "Test"

Pridajte popis (voliteľne, ale odporúčané):

Stručný prehľad toho, čo agent robí
Pomáha členom tímu pochopiť, kedy ho použiť
Príklad: "Recenzuje Python kód na osvedčené postupy, bezpečnostné problémy a možnosti optimalizácie"

Krok 3: Vyberte model

Vyberte AI model, ktorý pohana vášho agenta:

Dostupné modely:

Claude 3.5 Sonnet (Odporúčané)
- ID: claude-3-5-sonnet-20241022
- Najlepší pomer rýchlosti, kvality a nákladov
- Okno 200K tokenov
- Výborný pre všeobecné úlohy
Claude 3 Opus
- ID: claude-3-opus-20240229
- Najvýkonnejší model
- Najlepší pre komplexné úvahy
- Vyššie náklady, pomalšie odpovede
Claude 3.5 Haiku
- ID: claude-3-5-haiku-20241022
- Najrýchlejší a nákladovo najefektívnejší
- Skvelý pre jednoduché úlohy
- 200K okno kontextu

Príklad výberu modelu:

Prípad použitia	Odporúčaný model
Recenzia kódu, analýza	Claude 3.5 Sonnet
Tvorba obsahu	Claude 3.5 Sonnet
Jednoduchá otázka	Claude 3.5 Haiku
Komplexný výskum	Claude 3 Opus
Analýza údajov	Claude 3.5 Sonnet
Rýchle odpovede	Claude 3.5 Haiku

Krok 4: Konfigurácia systémového pokyny

Systémový pokyn definuje osobnosť, odbornosť a správanie vášho agenta.

Kliknutie na "Upraviť systémový pokyn" a zadajte svoje pokyny.

Detailné pokyny nájdete v sekcii Konfigurácia systémových pokynov nižšie.

Krok 5: Nastavenie viditeľnosti

Vyberte si, kto má prístup k tomuto agentovi:

Možnosti:

Súkromný (Predvolenie)
- Iba vy môžete vidieť a používať tohto agenta
- Najlepší pre osobné experimenty alebo citlivú prácu
Organizácia
- Všetci členovia vašej organizácie ho môžu používať
- Najlepší pre spoluprácu tímu
Verejný
- Ktokoľvek s odkazom môže ho vidieť (iba na čítanie)
- Vykonanie vyžaduje členstvo v organizácii
- Najlepší na predvádzanie alebo zdieľanie demonštácií

Krok 6: Vytvorenie agenta

Kliknutie na "Vytvoriť agenta" na finalizáciu.

Budete presmerovaní na stránku podrobností agenta, kde môžete:

Testovať agenta
Zobraziť históriu vykonávania
Upraviť konfiguráciu
Pridať nástroje a pluginy

Metóda 2: Cez API

Požiadavka na vytvorenie agenta:

curl -X POST "https://cc.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Recenzent Python kódu",
    "description": "Recenzuje Python kód na osvedčené postupy a bezpečnosť",
    "systemPrompt": "Ste skúsený Python vývojár s viac ako 10 rokmi skúsenosti. Recenzujte kód pre:\n\n1. Osvedčené postupy a PEP 8 zhodu\n2. Bezpečnostné zraniteľnosti\n3. Optimalizácie výkonu\n4. Čitateľnosť a udržiavateľnosť kódu\n\nPoskytnite špecifickú, akčnú spätnu väzbu s príkladmi kódu.",
    "model": "claude-3-5-sonnet-20241022",
    "visibility": "organization"
  }'

Odozva:

{
  "id": "char_abc123xyz",
  "name": "Recenzent Python kódu",
  "description": "Recenzuje Python kód na osvedčené postupy a bezpečnosť",
  "systemPrompt": "Ste skúsený Python vývojár...",
  "model": "claude-3-5-sonnet-20241022",
  "visibility": "organization",
  "organizationId": "org_xyz789",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T10:00:00Z",
  "metadata": {}
}

Uložte ID agenta (char_abc123xyz) na budúce volania API.

Konfigurácia systémových pokynov

Systémový pokyn je najdôležitejšou časťou konfigurácii vášho agenta. Definuje osobnosť, odbornosť a správanie.

Anatómia dobrého systémového pokynu

1. Úloha a odbornosť

Ste starší softvérový inžinier špecializujúci sa na Python a vývoj backendu s viac ako 10 rokmi skúsenosti.

2. Základné zodpovednosti

Vaše primárne zodpovednosti sú:
- Recenzia kódu na osvedčené postupy
- Identifikácia bezpečnostných zraniteľností
- Návrh optimalizácií výkonu
- Zabezpečenie udržiavateľnosti kódu

3. Štýl komunikácie

Pri poskytovaní spätnej väzby:
- Buďte konštruktívni a povzbudzujúci
- Poskytnite špecifické príklady
- Vysvetlite "prečo" za návrhmi
- Uprednostnite problémy podľa závažnosti

4. Obmedzenia a pokyny

Pokyny:
- Zamerajte sa na funkcie Python 3.10+
- Postupujte podľa sprievodcu štýlom PEP 8
- Uprednostnite čitateľnosť pred záludnosťou
- Zvážte štandardy kódovania tímu

Príklady systémových pokynov

Príklad 1: Agent recenzent kódu

Ste odborný recenzent kódu s hlbokými vedomosťami o osvedčených postupoch vývoja softvéru, bezpečnosti a optimalizácii výkonu.

Pri recenzii kódu:

1. **Bezpečnosť**: Identifikujte zraniteľnosti (SQL injection, XSS, problémy s autentifikáciou)
2. **Výkon**: Identifikujte neefektívne algoritmy, zbytočné slučky, úniky pamäte
3. **Udržiavateľnosť**: Skontrolujte jasné pomenovanie, správnu abstrakciu, dokumentáciu
4. **Osvedčené postupy**: Zabezpečte dodržavanie konvencií a vzorov jazyka

Poskytujte spätnu väzbu v tomto formáte:
- 🔴 Kritické: Bezpečnostné zraniteľnosti alebo zlyhávajúce problémy
- 🟡 Dôležité: Problémy s výkonom alebo obavami z udržiavateľnosti
- 🟢 Návrhy: Príjemné vylepšenia

Vždy zahrňte príklady kódu s opravou.

Príklad 2: Agent pisateľ obsahu

Ste profesionálny pisateľ obsahu špecializujúci sa na technické blogové články a marketingové kopírovanie.

Váš štýl písania:
- Jasný a stručný
- Pútavý a konverzačný
- Technicky presný, ale dostupný
- SEO-optimalizovaný s prirodzeným použitím kľúčových slov

Pri vytváraní obsahu:
1. Začnite pútavým háčikom
2. Používajte krátke odstavce (2-3 vety)
3. Zahrňte relevantné príklady a analógie
4. Skončite jasným výzvou k akcii

Cieľová skupina: Softvéroví vývojári a technickí rozhodovatelia

Tón: Profesionálny, ale priateľský, autoritatívny, ale prístupný

Príklad 3: Agent analytik údajov

Ste starší analytik údajov s odbornosťou v štatistickej analýze, vizualizácii údajov a business intelligence.

Pri analýze údajov:
1. Začnite s exploračnou analýzou údajov (EDA)
2. Identifikujte vzorce, trendy a anomálie
3. Vykonajte štatistické testy, keď je to vhodné
4. Vytvorte jasné, akčné vizualizácie
5. Poskytnite obchodné odporúčania

Prezentujte zistenia v tejto štruktúre:
- **Zhrnutie**: Kľúčové poznatky v 2-3 vetách
- **Analýza**: Podrobný rozpis s podpornými údajmi
- **Vizualizácia**: Navrhnite vhodné grafy/grafy
- **Odporúčania**: Akčné ďalšie kroky

Použite Python (pandas, matplotlib, seaborn) na prácu s údajmi.

Osvedčené postupy systémového pokynu

Áno:

✅ Buďte špecifickí o úlohe a odbornosti agenta
✅ Definujte jasné zodpovednosti a priority
✅ Špecifikujte formát výstupu a štruktúru
✅ Zahrňte príklady požadovaného správania
✅ Nastavte hranice a obmedzenia
✅ Definujte štýl komunikácie a tón

Nie:

❌ Buďte príliš vágni ("Ste užitočný")
❌ Zahrňte protichodné pokyny
❌ Urobte pokyny zbytočne dlhé (držte sa pod 500 slov)
❌ Zabudnite špecifikovať formát výstupu
❌ Predpokladajte kontext, ktorý nie je poskytnutý

Testovanie a iterácia

Počiatočný test:

Vytvorte agenta s vašim pokinom
Spustite 5-10 testovacích dotazov
Hodnotujte odpovede

Iterácia:

Identifikujte problémy (príliš podrobný, chýbajúce kľúčové info, zlý tón)
Aktualizujte systémový pokyn
Testujte znova
Opakujte, kým nebudete spokojný

Výber správneho modelu

Porovnanie modelov

Model	Kontext	Rýchlosť	Náklady	Najlepší pre
Claude 3.5 Sonnet	200K	Rýchly	Stredný	Všeobecné úlohy, vyvážená kvalita
Claude 3 Opus	200K	Pomaly	Vysoký	Komplexné úvahy, kritické úlohy
Claude 3.5 Haiku	200K	Najrýchlejší	Nízky	Jednoduché úlohy, vysoký objem

Kedy používať jednotlivé modely

Claude 3.5 Sonnet (Predvolenie - Najlepší pre väčšinu prípadov)

Recenzia a generovanie kódu
Tvorba obsahu
Analýza údajov
Podpora zákazníkov
Všeobecná automatizácia

Claude 3 Opus (Premium - Komplexné úlohy)

Pokročilý výskum a analýza
Kritické rozhodovanie
Komplexné riešenie problémov
Právna alebo medicínska analýza
Obsah s vysokymi stavkami

Claude 3.5 Haiku (Ekonomika - Vysoký objem)

Jednoduchá otázka
Klasifikácia údajov
Zmierňovanie obsahu
Rýchle zhrnutie
Smerovanie a triedenie

Nastavenie viditeľnosti

Viditeľnosť riadi, kto môže pristupovať a používať vášho agenta.

Možnosti viditeľnosti

1. Súkromný

Kto má prístup: Iba vy
Prípad použitia: Osobné experimenty, citlivá práca
Zdieľanie: Nemožno zdieľať

2. Organizácia

Kto má prístup: Všetci členovia organizácie
Prípad použitia: Spolupráca tímu, zdieľané misie
Zdieľanie: Automatické pre členov org

3. Verejný

Kto má prístup: Ktokoľvek s odkazom (iba prehliadanie)
Prípad použitia: Demá, predvádzanie, verejné nástroje
Zdieľanie: Zdieľanie založené na odkazoch
Poznámka: Vykonanie stále vyžaduje členstvo v organizácii

Testovanie vášho agenta

Interaktívne testovanie

Cez rozhranie - Rozhranie chatu:

Prejdite na stránku podrobností agenta
Kliknutie na "Chat" tab
Zadajte testovacú správu
Skontrolujte odpoveď

Testovacia scenária:

Scenário 1: Základná kapacita

Správa: "Ahoj! Na čo si navrhnutý?"
Očakávané: Agent popisuje svoju úlohu a možnosti

Scenário 2: Špecifická úloha

Správa: "Zrecenzujte túto Python funkciu: [vložte kód]"
Očakávané: Podrobná recenzia s konkrétnou spätnou väzbou

Scenário 3: Hraničný prípad

Správa: "Môžete mi pomôcť s JavaScriptom?"
Očakávané: Agent buď pomôže, alebo vysvetlí, že je špecializovaný na Python

Testovanie API

Spustenie agenta:

curl -X POST "https://cc.teamday.ai/api/v1/agents/char_abc123/execute" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Zrecenzujte tento kód: def get_user(id): return db.query(\"SELECT * FROM users WHERE id=\" + id)"
  }'

Odozva:

{
  "executionId": "exec_xyz789",
  "message": "🔴 **Kritická bezpečnostná chyba**: Zraniteľnosť SQL injection\n\nVáš kód je zraniteľný na útoky SQL injection...",
  "status": "completed",
  "usage": {
    "inputTokens": 156,
    "outputTokens": 234
  }
}

Osvedčené postupy

1. Začnite jednoducho, iterujte

Počiatočný agent:

Ste recenzent kódu. Recenzujte kód na chyby a osvedčené postupy.

Po testovaní:

Ste odborný recenzent Python kódu špecializujúci sa na bezpečnosť a výkon.

Pri recenzii kódu:
1. Skontrolujte bezpečnostné zraniteľnosti
2. Identifikujte úzke miesta výkonu
3. Zabezpečte dodržavanie PEP 8
4. Overte správne spracovanie chýb

Poskytujte spätnu väzbu s:
- Závažnosťou problému
- Špecifickým miestom v kóde
- Príkladom opravy
- Stručným vysvetlením

2. Používajte popisné názvy

Dobré názvy:

✅ "Auditor bezpečnosti Python"
✅ "Pisateľ marketingového blogu"
✅ "Trieder podpory zákazníkov"

Zlé názvy:

❌ "Agent 1"
❌ "Všeobecný pomocník"
❌ "Test Bot"

3. Dokumentujte svojich agentov

{
  "name": "Recenzent Python kódu",
  "description": "Automatizovaná recenzia kódu so zameraním na bezpečnosť, výkon a osvedčené postupy pre Python 3.10+ kódové základy",
  "metadata": {
    "purpose": "code-review",
    "languages": ["python"],
    "focusAreas": ["security", "performance", "style"],
    "team": "engineering",
    "version": "2.0"
  }
}

4. Testujte dôkladne

Matica testov:

Typ testu	Príklad
Šťastný cesta	Normálny, očakávaný vstup
Hraničné prípady	Prázdny vstup, veľmi dlhý vstup
Neplatný vstup	Zlý formát, chýbajúce údaje
Hraničné prípady	Maximálna dĺžka, špeciálne znaky

Riešenie problémov

Agent nereaguje podľa očakávania

Problém: Agent poskytuje generické odpovede

Riešenia:

Viac špecifických systémových pokynov
Pridajte konkrétne príklady požadovaného výstupu
Testujte s rôznymi formuláciami
Zvážte prepnutie na výkonnejší model

Odpovede príliš zložité

Problém: Agent píše príliš veľa textu

Riešenie: Pridajte do systémového pokynu:

Udržujte odpovede stručné (pod 200 slov, pokiaľ nie je potrebný viac detailov).
Používajte bodové zoznamy na zoznamy.

Blahoželáme k vytvoreniu vášho prvého agenta! Pokračujte skúmaním ďalších sprievodcov a integráciou.