2 lines
4.6 KiB
JavaScript
2 lines
4.6 KiB
JavaScript
import{c as e,Q as t,j as r,m as a}from"./chunks/framework.BPKcPtvA.js";const h=JSON.parse('{"title":"Troubleshooting & FAQ","description":"","frontmatter":{},"headers":[],"relativePath":"troubleshooting.md","filePath":"troubleshooting.md","lastUpdated":null}'),s={name:"troubleshooting.md"};function n(i,o,l,d,c,p){return t(),r("div",null,[...o[0]||(o[0]=[a('<h1 id="troubleshooting-faq" tabindex="-1">Troubleshooting & FAQ <a class="header-anchor" href="#troubleshooting-faq" aria-label="Permalink to "Troubleshooting & FAQ""></a></h1><h2 id="installation" tabindex="-1">Installation <a class="header-anchor" href="#installation" aria-label="Permalink to "Installation""></a></h2><p><strong>Q: <code>pip install anthropic</code> fails with SSL error</strong><br> A: Update pip: <code>python -m pip install --upgrade pip</code>. If on Windows behind a corporate proxy, set <code>set HTTPS_PROXY=http://proxy:port</code>.</p><p><strong>Q: <code>python</code> not found on Windows</strong><br> A: Install from python.org. Check "Add Python to PATH" during installation.</p><p><strong>Q: <code>ModuleNotFoundError: No module named 'yaml'</code></strong><br> A: <code>pip install pyyaml</code></p><h2 id="labs" tabindex="-1">Labs <a class="header-anchor" href="#labs" aria-label="Permalink to "Labs""></a></h2><p><strong>Q: Lab returns "No input provided"</strong><br> A: Check you're passing <code>messages</code> parameter, not <code>prompt</code>. The mock LLM expects: <code>messages=[{"role": "user", "content": "your prompt"}]</code></p><p><strong>Q: Agent loops forever</strong><br> A: <code>MAX_ITERATIONS</code> is not set or is too high. Set it to 10-15 for labs.</p><p><strong>Q: Tool call returns empty result</strong><br> A: The mock LLM generates tool calls based on keyword detection. If your prompt doesn't contain trigger words (read, search, write), it won't generate tool calls.</p><p><strong>Q: <code>str_replace_editor</code> not found</strong><br> A: That's an Anthropic-specific tool type. The mock LLM only supports basic tool_use blocks. Use the standard tool format shown in the labs.</p><h2 id="skills" tabindex="-1">Skills <a class="header-anchor" href="#skills" aria-label="Permalink to "Skills""></a></h2><p><strong>Q: Installed skills don't appear in <code>/skills</code> menu</strong><br> A: Restart Claude Code after installation. Skills are loaded at startup.</p><p><strong>Q: Skill says "not user-invocable"</strong><br> A: Check the YAML frontmatter has <code>user-invocable: true</code>. Kit master files intentionally omit this (they're documentation, not invocable skills).</p><p><strong>Q: <code>$ARGUMENTS</code> not being replaced</strong><br> A: <code>$ARGUMENTS</code> is a placeholder. The agent (Claude Code / Pi) replaces it with your input when you invoke the skill via <code>/command</code>.</p><h2 id="api-keys" tabindex="-1">API Keys <a class="header-anchor" href="#api-keys" aria-label="Permalink to "API Keys""></a></h2><p><strong>Q: "This model is not available" from Anthropic</strong><br> A: You might need to request access to Claude Sonnet 4 / Opus 4. Check <a href="https://docs.anthropic.com" target="_blank" rel="noreferrer">docs.anthropic.com</a> for available models for your tier.</p><p><strong>Q: Mock LLM works but real API returns 401</strong><br> A: Check <code>ANTHROPIC_API_KEY</code> is set correctly. Test with: <code>python -c "import os; print(os.environ.get('ANTHROPIC_API_KEY', 'NOT SET')[:10])"</code></p><p><strong>Q: OpenRouter returns 402 Payment Required</strong><br> A: Your free credits may be exhausted. Add payment method or switch to a different provider.</p><h2 id="general" tabindex="-1">General <a class="header-anchor" href="#general" aria-label="Permalink to "General""></a></h2><p><strong>Q: The course files use <code>\\u2192</code> characters that show as garbage</strong><br> A: The course uses Unicode arrows (→) in diagrams. If your terminal doesn't support UTF-8, set <code>$env:PYTHONIOENCODING='utf-8'</code> on Windows or use a UTF-8 capable terminal (Windows Terminal, iTerm2, Ghostty).</p><p><strong>Q: How do I cite this course?</strong><br> A: Reference "Agentic Engineering Course" with the module and lesson number.</p><p><strong>Q: Can I teach this course?</strong><br> A: Course materials are provided for personal study. Contact for teaching license.</p>',22)])])}const g=e(s,[["render",n]]);export{h as __pageData,g as default};
|