echolot agent

echolot agent даёт задачу встроенному агенту — тому же, что и Ассистент, — и позволяет ему работать с инструментами рабочего пространства, пока он не закончит. Одобрять некому, поэтому всё, что ему можно, решает политика. Используйте его в CI («проверь каждый запрос и сообщи, что не проходит») или в скриптах.

echolot agent [<options>] <task>

<task> — то, что агент должен сделать, обычными словами.

Запуск задачиCopy Anchor Link

export ANTHROPIC_API_KEY=…
echolot agent "Check every request of the Catalog folder and report what fails" -w Alpenglow.echolot

Ответ модели идёт в стандартный вывод по мере написания. В конце в стандартный поток ошибок выводится сводка:

Agent finished: 9 tool calls, 18234 in, 1210 out.

-v дополнительно печатает в стандартный поток ошибок каждый вызов инструмента и его результат (→ send_request …, ← send_request ok in 82 ms). --json вместо этого печатает весь сеанс как JSON: каждое сообщение, вызов инструмента и результат, расход токенов и чем всё закончилось.

Провайдеры и моделиCopy Anchor Link

--key-env называет другую переменную окружения для ключа. Храните ключи в секретах вашего CI или получайте их при запуске команды:

op run --env-file agent-keys.env -- echolot agent "Save every product as CSV" \
  -w Alpenglow.echolot --provider openai --model gpt-5.5 --policy-file ci-policy.toml --json

Бесплатный прогон на вашем Mac:

echolot agent "List the requests that have no checks" -w Alpenglow.echolot \
  --provider openai-compatible --model qwen3:4b

ПолитикиCopy Anchor Link

Инструменты агента — это инструменты MCP-сервера Echolot, с той же защитой: секретные значения никогда не доходят до модели, и всё, что видит модель, проходит через то же вычищение. Что можно каждому виду действий, определяет политика:

Когда человека нет, «спросить» означает «отказать».

Файл политики смягчает или ужесточает базовую политику для каждого вида действий. Он принимает те же правила, что и раздел [agents] рабочего пространства, с обрамляющим [agents] или без него:

# ci-policy.toml: разрешить агенту отправлять что угодно на хосты рабочего пространства, но не менять само рабочее пространство
[rules]
unsafe-send = "allow"
workspace-write = "refuse"
destructive = "refuse"

Каждое принимает allow, ask или refuse. protected-send и new-host можно ужесточить, но нельзя разрешить безоговорочно.

Файл политики считается вашим, поэтому он может смягчать политику. Собственные правила [agents] рабочего пространства только ужесточают её, если вы не передали --trust-workspace-policy.

ЛимитыCopy Anchor Link

--max-steps останавливает прогон после стольких ходов модели (по умолчанию 30). --token-budget останавливает его, когда израсходовано столько токенов. Прогон, остановленный лимитом, завершается с кодом 1.

ПараметрыCopy Anchor Link

Наборы инструментов описаны на странице echolot mcp.

Коды выходаCopy Anchor Link