# connect-hosted-toolbox

Субагент connect-hosted-toolbox для переключения Azure AI Foundry toolbox на новую базу знаний без пересборки агента. Читает текущую конфигурацию, проверяет права доступа и готовит план изменений.

- субагент · `type=agent` · Claude Code, GitHub Copilot, Codex, Cursor · ★ 3232 у репозитория
- Автор: Microsoft
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/microsoft/skills/tree/HEAD/.github/plugins/foundry-iq-skills/skills/foundry-iq/agents/connect-hosted-toolbox.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/connect-hosted-toolbox

## Что делает

Субагент работает с проектами Azure AI Foundry: принимает имя проекта, базы знаний и toolbox, проверяет существующие подключения и права агента (Search Index Data Reader для индекса, Foundry User для проекта), затем сохраняет план в `intent.json` и запускает `python helpers/hosted_connect.py --plan intent.json`. Скрипт возвращает таблицу изменений: какой endpoint и версия toolbox будут после переключения, какие агенты затронуты.

Выполнение ограничено чтением: субагент не создаёт версии toolbox и не меняет default. Если текущая конфигурация совпадает с выбранной, статус `planned`; если нет — `blocked`, и нужно одобрение владельца. Promotion меняет default для всех потребителей toolbox сразу, откат требует отдельного плана.

Требуется аутентификация `RemoteTool` + `AgenticIdentityToken` с audience `https://search.azure.com/`. Endpoint формируется как `<project-endpoint>/toolboxes/<name>/mcp?api-version=v1`; закреплённые версии `/versions/<version>/mcp` не эквивалентны. Без FFmpeg и Python скрипт не запустится.

## Требования
- Работает с: Azure

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add microsoft/skills
```
В чате агента (не в терминале):
```text
/plugin install foundry-iq-skills@skills
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/connect-hosted-toolbox.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/connect-hosted-toolbox.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/connect-hosted-toolbox.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/skills/tree/HEAD/.github/plugins/foundry-iq-skills/skills/foundry-iq/agents/connect-hosted-toolbox.md

## Когда брать
- переключить Azure AI Foundry toolbox на другую базу знаний без редеплоя агента
- проверить права доступа агента к Search и проекту перед изменением toolbox
- получить список затронутых агентов при смене default версии toolbox
- сохранить план подключения для одобрения владельцем сервиса

## Примеры запросов агенту
- Проверь, может ли агент `customer-support` читать базу знаний `product-docs` в проекте `ai-prod-001`, и собери план подключения
- Сохрани в `intent.json` конфигурацию для переключения toolbox `main-tools` на KB `faq-index` в подписке `<sub-id>`, группе `rg-ai`
- Запусти `python helpers/hosted_connect.py --plan intent.json` и покажи таблицу изменений

## Похожие
- [azure-ml-foundry-workspace](https://affpapa.org/nevibecode/skills/azure-ml-foundry-workspace.md) — скилл · 105 установок
- [azure-cost-health-check](https://affpapa.org/nevibecode/plugins/azure-cost-health-check.md) — плагин · ★ 11 у репозитория
- [azure-functions-hosted-skills](https://affpapa.org/nevibecode/plugins/azure-functions-hosted-skills.md) — плагин · ★ 11 у репозитория
- [foundry-hosted-agent-copilotkit](https://affpapa.org/nevibecode/skills/foundry-hosted-agent-copilotkit.md) — скилл · 29 установок
- [hosted-mcp-tools](https://affpapa.org/nevibecode/agents/hosted-mcp-tools.md) — субагент · ★ 521 у репозитория
- [dynamodb-toolbox-patterns](https://affpapa.org/nevibecode/skills/dynamodb-toolbox-patterns.md) — скилл · 3700 установок

Из того же набора: [microsoft/skills](https://affpapa.org/nevibecode/by/microsoft/skills.md) — 250 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
