CLI, SDK и библиотекиant CLI

Скриптинг и автоматизация с помощью CLI

Храните ресурсы API под контролем версий в виде YAML, объединяйте команды ant CLI в скрипты и работайте с ресурсами из Claude Code.

На этой странице описаны ориентированные на задачи рабочие процессы, построенные на основе ant CLI. Описание базовых флагов и параметров вывода см. в разделе Использование CLI.

Контроль версий ресурсов API

Вы можете использовать CLI для контроля версий ресурсов API, таких как навыки, агенты, окружения или развёртывания, в виде YAML-файлов в вашем репозитории и поддерживать их синхронизацию с Claude API.

Подробнее об этих ресурсах см. в разделе Управляемые агенты.

Определите агента

Запишите определение агента в файл summarizer.agent.yaml:

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

Создайте агента
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Обратите внимание на id в ответе. Вы передадите его в команду создания сессии на одном из следующих шагов.
Добавьте summarizer.agent.yaml в ваш репозиторий и поддерживайте его синхронизацию с API в вашем CI-конвейере. Команде обновления требуются идентификатор агента и текущая версия в виде флагов:
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Определите окружение
Сессия выполняется в окружении, которое определяет песочницу, в которой она запускается. Запишите определение окружения в файл summarizer.environment.yaml:
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Создайте окружение
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
Обратите внимание на id в ответе. Вы передадите его в команду создания сессии на одном из следующих шагов.
Добавьте summarizer.environment.yaml в ваш репозиторий и поддерживайте его синхронизацию с API в вашем CI-конвейере. Команде обновления требуется идентификатор окружения в виде флага:
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Запустите сессию

Вставьте id агента и id окружения из предыдущих выводов в команду создания сессии:

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Output

{
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

Отправьте сообщение пользователя

Скопируйте id сессии из предыдущего вывода в --session-id:

ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

Прочитайте диалог
--transform применяется к каждому перечисленному событию, поэтому эта команда выводит текст каждого сообщения по порядку. --format auto переопределяет интерактивный обозреватель, который команды списка открывают по умолчанию в терминале:
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
Output
```
Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
```
Чтобы наблюдать за сессией во время её выполнения, используйте ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. События записываются в stdout по мере их поступления.

Паттерны скриптинга

CLI спроектирован так, чтобы сочетаться со стандартными инструментами командной оболочки.

Передача вывода списка во вторую команду

--transform id --raw-output на конечной точке списка выводит по одному «голому» идентификатору на строку, поэтому стандартные инструменты, такие как head и xargs, применяются напрямую. Захватите первый результат, затем передайте его в следующую команду:

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl

Анализ ошибок

Флаги --transform-error и --format-error применяют ту же фильтрацию к ответам с ошибками. --raw-output не применяется к ошибкам, поэтому используйте --format-error yaml для получения скаляра без кавычек. Извлеките только сообщение об ошибке:

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

Output

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.

Использование CLI из Claude Code

Claude Code может использовать ant CLI «из коробки». Если CLI установлен и аутентифицирован, вы можете попросить Claude Code работать с вашими ресурсами API напрямую. Например:

«Выведи список моих недавних сессий агентов и кратко опиши, какие из них завершились с ошибкой».
«Загрузи каждый PDF из ./reports в Files API и выведи полученные идентификаторы».
«Получи события для сессии session_01... и скажи мне, где агент застрял».

Claude Code вызывает ant через командную оболочку, разбирает структурированный вывод и анализирует результаты (никакого специального кода интеграции не требуется).

Was this page helpful?

CLI, SDK и библиотекиant CLI

Скриптинг и автоматизация с помощью CLI

Контроль версий ресурсов API

Подробнее об этих ресурсах см. в разделе Управляемые агенты.

Определите агента

Запишите определение агента в файл summarizer.agent.yaml:

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

Создайте агента
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Обратите внимание на id в ответе. Вы передадите его в команду создания сессии на одном из следующих шагов.
Добавьте summarizer.agent.yaml в ваш репозиторий и поддерживайте его синхронизацию с API в вашем CI-конвейере. Команде обновления требуются идентификатор агента и текущая версия в виде флагов:
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Определите окружение
Сессия выполняется в окружении, которое определяет песочницу, в которой она запускается. Запишите определение окружения в файл summarizer.environment.yaml:
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Создайте окружение
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
Обратите внимание на id в ответе. Вы передадите его в команду создания сессии на одном из следующих шагов.
Добавьте summarizer.environment.yaml в ваш репозиторий и поддерживайте его синхронизацию с API в вашем CI-конвейере. Команде обновления требуется идентификатор окружения в виде флага:
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Запустите сессию

Вставьте id агента и id окружения из предыдущих выводов в команду создания сессии:

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

Output

{
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

Отправьте сообщение пользователя

Скопируйте id сессии из предыдущего вывода в --session-id:

ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

Прочитайте диалог
--transform применяется к каждому перечисленному событию, поэтому эта команда выводит текст каждого сообщения по порядку. --format auto переопределяет интерактивный обозреватель, который команды списка открывают по умолчанию в терминале:
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
Output
```
Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.
```
Чтобы наблюдать за сессией во время её выполнения, используйте ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. События записываются в stdout по мере их поступления.

Паттерны скриптинга

CLI спроектирован так, чтобы сочетаться со стандартными инструментами командной оболочки.

Передача вывода списка во вторую команду

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl

Анализ ошибок

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

Output

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.

Использование CLI из Claude Code

«Выведи список моих недавних сессий агентов и кратко опиши, какие из них завершились с ошибкой».
«Загрузи каждый PDF из ./reports в Files API и выведи полученные идентификаторы».
«Получи события для сессии session_01... и скажи мне, где агент застрял».

Was this page helpful?