Антропический Клод

agent-framework-claude упаковывает пакет SDK агента Claude как ClaudeAgent. Используются управляемая среда выполнения агентов Claude, сеансы, модель прав доступа, встроенные инструменты и поддержка MCP, при этом предоставляются интерфейсы выполнения и потоковой передачи Agent Framework.

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

Prerequisites

  • Установите и настройте CLI Claude Code.
  • Выберите модель Claude и режим разрешений.
  • Запустите агент в ограниченном рабочем каталоге при включении инструментов работы с файлами или оболочкой.

Установите пакет

pip install agent-framework-claude --pre

Configuration

Variable Purpose
CLAUDE_AGENT_MODEL Модель Claude, используемая управляемой средой выполнения.
CLAUDE_AGENT_PERMISSION_MODE Режим разрешений по умолчанию для встроенных инструментов и инструментов MCP.
CLAUDE_AGENT_CLI_PATH Необязательный явно указанный путь к утилите командной строки Claude Code.
CLAUDE_AGENT_CWD Рабочий каталог, доступный среде выполнения.
CLAUDE_AGENT_MAX_TURNS Необязательное максимальное количество ходов агента.
CLAUDE_AGENT_MAX_BUDGET_USD Необязательный бюджет затрат на запуск.

Явные нулевые значения для max_turns и max_budget_usd перенаправляются в пакет SDK агента Claude. Пропускаются только неустановленные (None) значения.

Создайте ClaudeAgent

ClaudeAgent поддерживает обычные и потоковые запуски и может предоставлять инструменты функций Agent Framework.

async def non_streaming_example() -> None:
    """Example of non-streaming response."""
    print("=== Non-streaming Example ===")

    agent = ClaudeAgent(
        name="BasicAgent",
        instructions="You are a helpful assistant. Keep responses concise.",
        tools=[get_weather],
    )

    async with agent:
        query = "What's the weather in Seattle?"
        print(f"User: {query}")
        result = await agent.run(query)
        print(f"Agent: {result.text}\n")


async def streaming_example() -> None:
    """Example of streaming response."""
    print("=== Streaming Example ===")

    agent = ClaudeAgent(
        name="StreamingAgent",
        instructions="You are a helpful assistant.",
        tools=[get_weather],
    )

    async with agent:
        query = "What's the weather in Paris?"
        print(f"User: {query}")
        print("Agent: ", end="", flush=True)
        async for chunk in agent.run(query, stream=True):
            if chunk.text:
                print(chunk.text, end="", flush=True)
        print("\n")

Дополнительные примеры демонстрируют:

  • Встроенные инструменты Клода для работы с файлами и оболочкой.
  • Интерактивная обработка разрешений.
  • Локальные и удаленные серверы MCP.
  • Сохраняемость сеанса и возобновление.
  • Последовательные рабочие процессы, которые передают предыдущие сообщения между агентами Claude.
  • Загрузка URL-адресов и несколько правил разрешений.

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

Соображения, касающиеся разрешений

  • Начните с режима доступа Claude Agent SDK с минимально необходимыми разрешениями, который поддерживает выполнение задачи.
  • Требовать явного разрешения для операций в командной оболочке, с файлами, сетью и других операций с побочными эффектами.
  • Не предоставляйте учетные данные через переменные среды или доступные для чтения файлы в рабочем каталоге агента.

Дальнейшие действия