# connect-hosted

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

- субагент · `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.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/connect-hosted

## Что делает

Субагент инспектирует удалённого агента через `azd ai agent show`, читает его principal, подключения и toolbox. Перед изменениями проверяет права runtime principal — Search Index Data Reader на ресурс поиска и Foundry User на проект. Создаёт недостающие ресурсы только после одобрения: remote-tool подключение к MCP-эндпойнту базы знаний с auth-type `agentic-identity` и audience `https://search.azure.com/`, toolbox из YAML-файла с описанием и именем подключения.

Выбирает режим привязки toolbox — endpoint (переменная `TOOLBOX_ENDPOINT` с адресом `<project-endpoint>/toolboxes/<toolbox-name>/mcp?api-version=v1`) или name (переменная `TOOLBOX_NAME`). Разворачивает изменения через `azd deploy` только если удалённая конфигурация отличается. Проверяет работу двумя вызовами `azd ai agent invoke` с `--protocol responses` и фиксированной версией: первый создаёт сессию, второй использует её ID с новой беседой, чтобы убедиться в изоляции.

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

## Установка

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

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- подключить Claude Code к развёрнутому Azure AI агенту без пересоздания
- проверить права runtime principal агента на Search Index и Foundry
- связать toolbox с агентом через endpoint или имя переменной
- развернуть изменения конфигурации агента через azd
- проверить изоляцию сессий и бесед агента через Responses API

## Примеры запросов агенту
- Прочитай конфигурацию агента `research-bot` и проверь его права на Search Index Data Reader
- Создай toolbox `kb-tools` и свяжи его с агентом через переменную endpoint
- Разверни изменения агента `analytics-agent` и проверь новую версию двумя вызовами с разными беседами

## Похожие
- [azure-developer-cli](https://affpapa.org/nevibecode/skills/azure-developer-cli.md) — скилл · 32 установки
- [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 у репозитория
- [azure-deployment-preflight](https://affpapa.org/nevibecode/skills/azure-deployment-preflight.md) — скилл · 9591 установка
- [hosted-mcp-tools](https://affpapa.org/nevibecode/agents/hosted-mcp-tools.md) — субагент · ★ 521 у репозитория

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

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

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