Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
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 с минимально необходимыми разрешениями, который поддерживает выполнение задачи.
- Требовать явного разрешения для операций в командной оболочке, с файлами, сетью и других операций с побочными эффектами.
- Не предоставляйте учетные данные через переменные среды или доступные для чтения файлы в рабочем каталоге агента.