Разработка с Claude API

Запросы, потоковые ответы, tool use, структурированный вывод и стоимость.

92 уроков, первые 3 бесплатно. Полный доступ: 1490 руб.

Уроки курса

  1. Welcome to the course
  2. Overview of Claude models
  3. Accessing the API
  4. Getting an API key
  5. Making a request
  6. Multi-Turn conversations
  7. Chat exercise
  8. System prompts
  9. System prompts exercise
  10. Temperature
  11. Course satisfaction survey
  12. Response streaming
  13. Structured data
  14. Structured data exercise
  15. Quiz on accessing Claude with the API
  16. Prompt evaluation
  17. A typical eval workflow
  18. Generating test datasets
  19. Running the eval
  20. Model based grading
  21. Code based grading
  22. Exercise on prompt evals
  23. Quiz on prompt evaluation
  24. Prompt engineering
  25. Being clear and direct
  26. Being specific
  27. Structure with XML tags
  28. Providing examples
  29. Exercise on prompting
  30. Quiz on prompt engineering techniques
  31. Introducing tool use
  32. Project overview
  33. Tool functions
  34. Tool schemas
  35. Handling message blocks
  36. Sending tool results
  37. Multi-turn conversations with tools
  38. Implementing multiple turns
  39. Using multiple tools
  40. Fine grained tool calling
  41. The text edit tool
  42. The web search tool
  43. Quiz on tool use with Claude
  44. Introducing Retrieval Augmented Generation
  45. Text chunking strategies
  46. Text embeddings
  47. The full RAG flow
  48. Implementing the RAG flow
  49. BM25 lexical search
  50. A Multi-Index RAG pipeline
  51. Extended thinking
  52. Image support
  53. PDF support
  54. Citations
  55. Prompt caching
  56. Rules of prompt caching
  57. Prompt caching in action
  58. Code execution and the Files API
  59. Quiz on features of Claude
  60. Introducing MCP
  61. MCP clients
  62. Project setup
  63. Defining tools with MCP
  64. The server inspector
  65. Implementing a client
  66. Defining resources
  67. Accessing resources
  68. Defining prompts
  69. Prompts in the client
  70. MCP review
  71. Quiz on Model Context Protocol
  72. Anthropic apps
  73. Claude Code setup
  74. Claude Code in action
  75. Enhancements with MCP servers
  76. Agents and workflows
  77. Parallelization workflows
  78. Chaining workflows
  79. Routing workflows
  80. Agents and tools
  81. Environment inspection
  82. Workflows vs agents
  83. Quiz on Agents and Workflows
  84. Final Assessment
  85. Course Wrap Up
  86. What You'll Learn
  87. What You'll Learn
  88. What You'll Learn
  89. What You'll Learn
  90. What You'll Learn
  91. What You'll Learn
  92. What You'll Learn

Предоставление примеров в промптах: Улучшаем ответы Claude

В мире разработки с большими языковыми моделями (LLM) одним из наиболее мощных и эффективных методов промпт-инжиниринга является предоставление примеров. Этот подход, известный как "one-shot" (однократный) или "multi-shot" (многократный) промптинг, позволяет вам направлять ответы Claude, демонстрируя желаемое поведение с помощью пар "входные данные/выходные данные". Вместо того чтобы пытаться описать каждое нюанс словами, вы буквально показываете Claude, что именно вы хотите получить.

Как работают примеры

Представьте, что вы хотите, чтобы Claude анализировал тональность твитов, классифицируя их как "Позитивные" или "Негативные". На первый взгляд задача кажется простой. Однако в реальном мире язык полон тонкостей, таких как сарказм, который может сбить с толку даже человека, не говоря уже об ИИ.

Например, твит вроде: "Да, конечно, это был лучший фильм, который я видел со времен 'Плана 9 из открытого космоса'". Поверхностно он кажется позитивным из-за слов "лучший фильм" и "отличный". Но если вы знакомы с кинематографом, то знаете, что "План 9 из открытого космоса" печально известен как один из худших фильмов всех времен. Таким образом, этот твит на самом деле саркастический и должен быть классифицирован как "Негативный". Без дополнительных указаний Claude может ошибиться.

Обработка сложных случаев с помощью примеров

Чтобы научить Claude распознавать такие сложные случаи, как сарказм, вы можете добавить в свой промпт конкретные примеры. Эти примеры служат своего рода "учебником" для модели, показывая ей, как обрабатывать неоднозначные или пограничные ситуации. Улучшенный промпт будет включать в себя:

Важно отметить, что для структурирования этих примеров мы настоятельно рекомендуем использовать XML-теги. Например, вы можете обернуть каждый пример в теги <example> и </example>, а внутри них использовать теги для входных и выходных данных, такие как <input> и <output>. Такая структура делает промпт кристально ясным для Claude, однозначно указывая, что является примером, что — входными данными, а что — ожидаемым результатом.

Когда использовать примеры

Примеры особенно полезны в следующих сценариях:

One-Shot против Multi-Shot

Выбор между one-shot и multi-shot промптингом зависит от сложности вашей задачи:

Поиск эффективных примеров

Где взять хорошие примеры? Один из лучших источников — это результаты ваших собственных оценок промптов. Когда вы проводите тестирование и оценку ответов Claude, ищите те, которые получили наивысшие баллы (например, 10 из 10). Эти пары "входные данные/выходные данные" являются идеальными кандидатами для включения в ваш промпт. Используя их, вы показываете Claude, как выглядит "идеальный" результат для вашего конкретного случая использования.

Добавление контекста к примерам

Не ограничивайтесь просто предоставлением пары "входные данные/выходные данные". Чтобы сделать ваши примеры еще более мощными, добавьте контекст, объясняющий, почему этот вывод считается хорошим или идеальным. Например:

<ideal_output>
[Ваш пример идеального вывода здесь]
</ideal_output>
<explanation>
Этот пример хорошо структурирован, предоставляет подробную информацию
о выборе продуктов и их количестве, а также соответствует целям
и ограничениям спортсмена.
</explanation>

Этот дополнительный контекст помогает Claude понять не только формат или содержание хорошего ответа, но и логику, стоящую за ним. Это позволяет модели применять эти рассуждения к новым, ранее не встречавшимся входным данным.

Ключевые рекомендации по использованию примеров

Чтобы максимально эффективно использовать примеры в ваших промптах, следуйте этим рекомендациям:

Примеры особенно мощны, потому что они демонстрируют, а не просто рассказывают. Вместо того чтобы пытаться точно описать желаемое словами, вы показываете это напрямую. Это делает ваши промпты гораздо более надежными и помогает Claude понять тонкие требования, которые было бы трудно выразить одними лишь инструкциями.