Разработка с 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 "Видит" Мир и Адаптируется к Нему

При разработке интеллектуальных AI-агентов существует один фундаментальный концепт, который часто недооценивается: инспекция среды (environment inspection). Представьте себе, что вы пытаетесь выполнить сложную задачу с завязанными глазами. Вы можете получать инструкции, но без возможности видеть результаты своих действий, вы будете действовать вслепую. Точно так же и Claude: для эффективной работы ему необходимо иметь возможность наблюдать и понимать последствия своих действий.

Claude, как и любой другой большой языковой модели (LLM), по своей природе является "слепым" исполнителем. Он обрабатывает входные данные и генерирует выходные, но не имеет встроенного механизма для восприятия реального мира или цифровой среды, в которой он оперирует. Именно здесь на помощь приходит инспекция среды, превращая Claude из простого генератора текста в по-настоящему адаптивного и способного агента.

Почему Инспекция Среды Имеет Решающее Значение

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

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

Принцип "Сначала Прочитай, Потом Пиши"

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

Представьте, что вы просите Claude добавить новый маршрут (route) в существующий файл Python. Если Claude просто попытается вставить новый код, не прочитав файл целиком, он рискует нарушить существующую структуру, синтаксис или даже удалить важные части кода. Вместо этого, правильный подход заключается в том, чтобы Claude сначала прочитал весь файл, проанализировал его текущую структуру, идентифицировал подходящее место для вставки нового кода и только затем безопасно внес запрошенные изменения, не нарушая существующую функциональность. Этот принцип "сначала прочитай, потом пиши" гарантирует, что Claude действует осознанно и минимизирует риск ошибок.

Направляя Claude Через Системные Промпты

Вы можете активно направлять Claude на инспекцию его среды с помощью системных промптов (system prompts). Для выполнения сложных задач, таких как генерация видео, это становится особенно важным. Системный промпт — это набор инструкций, которые задают контекст и правила поведения для Claude на протяжении всей сессии.

Рассмотрим агента по созданию видео, которому необходимо:

В системный промпт для такого агента вы могли бы включить следующие инструкции:

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

Преимущества Эффективной Инспекции Среды

Когда Claude способен инспектировать свою среду, это приводит к нескольким значительным улучшениям:

Практическая Реализация Инспекции Среды

При разработке собственных агентов всегда задавайте себе вопрос: "Как Claude узнает, что это действие сработало?" Независимо от того, работаете ли вы с файлами, API или пользовательскими интерфейсами, всегда предоставляйте Claude инструменты и инструкции, которые позволяют ему наблюдать за результатами своих действий.

Это может означать:

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