Агенту нужны и понятная задача, и средства для её выполнения. Навык может описывать метод, инструмент выполняет операцию, а подключение обеспечивает доступ к внешнему сервису. Это отдельные части настройки.
Определите недостающую часть по проблеме
| Часть | Что она предоставляет | Пример |
|---|---|---|
| Инструкции агента | Роль, правила работы, ожидаемые решения и границы | Исследовать утверждения о продукте и отмечать неподтверждённые заявления |
| Навык | Многократно используемое письменное руководство для определённого вида работы | Повторяемый контрольный список проверки контента |
| Доступ к инструментам | Операции, которые агенту разрешено вызывать | Читать документы проекта или пользоваться браузером |
| Подключение приложения | Авторизованную учётную запись или подключение сервиса | Подключённую учётную запись Google или сервис MCP |
| Источник знаний | Материалы, доступные для поиска в соответствующей области | Утверждённый справочник по продукту |
| Контекст выполнения | Текущий проект, пространство и, при необходимости, кодовую базу или компьютер | Репозиторий, прикреплённый к этому проекту |
Установленный навык не подключает приложение, не выдаёт разрешения на инструменты и не делает отсутствующий файл доступным. Аналогично, подключение приложения не обязательно включает его инструменты для каждого агента.
Сначала попросите агента проверить доступ
Используйте конкретный запрос:
Прежде чем приступать к задаче, проверь, какими инструментами и подключениями ты действительно можешь пользоваться. Сообщи, какой необходимой возможности не хватает, требуется ли подключение или разрешение на инструмент и что я могу сделать дальше. Пока не меняй учётные записи и разрешения.
Текущая среда выполнения включает проверку возможностей и поиск инструментов. Агент может находить и загружать группы инструментов, которыми ему уже разрешено пользоваться. Загрузка делает эти инструменты видимыми для агента; она не расширяет разрешения. Поэтому появление Search Tool Groups (Поиск групп инструментов) или Load Tool Group (Загрузить группу инструментов) в журнале действий не доказывает, что создано новое подключение.
Подключайтесь через разговор
Попросите агента показать карточку подключения для приложения, нужного задаче. Он также может подготовить карточку пользовательского подключения MCP на основе проверенных общедоступных настроек сервера. Выберите Connect (Подключить), изучите настройки, авторизуйте нужную учётную запись или сервер, затем проверьте возвращённый статус подключения.
Карточка передаёт настройку под управление пользователя и сама по себе не выдаёт разрешения на инструменты. Текущий исходный код требует подходящую роль запрашивающего пользователя в организации и возможность запрашивать подключения у агента. Поэтому отсутствие карточки может быть связано с ролью или возможностями, а не с отсутствием поддержки сервиса.
Для пользовательского MCP успешное подключение создаёт отдельный пункт инструментов этого подключения. Агенту всё ещё нужно выдать разрешение на этот пункт. Для существующего встроенного приложения отсутствие разрешений провайдера или необходимость повторного подключения может снова привести к карточке подключения, тогда как исправное подключение без доступа у агента требует отдельного разрешения на соответствующие возможности инструментов.
Используйте такой диагностический запрос:
Проверь, связано ли это с отсутствующим или неисправным подключением, недостающей областью разрешений провайдера, отсутствием доступа агента к инструментам или источником, недоступным в этом пространстве. Покажи соответствующую карточку подключения, если настройка необходима и разрешена. Пока не меняй разрешения и не выполняй запись во внешних сервисах.
Вводите пароли, токены и другие учётные данные в специальной форме настройки. Не отправляйте их в чат. Уполномоченный человек может рассмотреть необходимый запрос возможностей агента или воспользоваться его настройками Tools (Инструменты).
Добавьте повторяемый метод
Если процедура должна применяться снова, запросите именованный навык вместо того, чтобы каждый раз повторять большой запрос:
Создай повторно используемый навык «Проверка контента на основе доказательств». Он должен требовать источник для каждого утверждения о продукте, сохранять неопределённости, проверять аудиторию и тон и возвращать черновик на проверку вместо публикации. Прикрепи его к этому агенту и сообщи, был ли он создан или использован существующий навык.
Согласно исходному коду, инструмент навыков создаёт принадлежащее организации руководство в Markdown и прикрепляет его к текущему агенту. Существующее имя может быть использовано повторно без перезаписи. Перед заменой общего руководства явно запросите согласие: на него могут полагаться другие агенты.
Чтобы изменить метод, назовите навык и нужное изменение. Попросите агента подтвердить сохранение навыка и его прикрепление, а не просто процитировать предлагаемый вариант в чате. Согласно текущему исходному коду, изменения применяются при последующих запусках. Создание и редактирование навыков не проверялись в демонстрации для документации.
Внимательно выбирайте интерфейс настройки
В доступных уполномоченным пользователям настройках агента представлены инструкции, навыки, инструменты и знания. Полное рабочее пространство агента и компактное диалоговое окно настроек в чате устроены по-разному. Некоторые учётные записи могут пользоваться агентом, но не могут открыть определённую страницу администрирования; см. Роли и доступ.
Возможности ассистента пространства определяются ролью. Это не просто специализированный агент со всеми включёнными инструментами. Статья Ассистент пространства поможет понять, что он координирует, а Руководитель проекта (PM) — кому поручить выполнение.
Устраняйте неполадки в правильном порядке
- Убедитесь, что выбраны нужные агент и проект.
- Попросите агента проверить доступные ему возможности.
- Проверьте, подключена ли нужная учётная запись.
- Проверьте выданные агенту разрешения на инструменты.
- Для сервисов, работающих с источниками, проверьте, прикреплён ли соответствующий источник к текущему пространству.
- Для программирования или работы с компьютером проверьте выбранную кодовую базу или среду выполнения.
- Повторите ограниченную операцию чтения, прежде чем переходить к записи со значимыми последствиями.
Не предполагайте, что все интеграции используют одну модель ресурсов. Одни используют подключение организации, другим нужны выбранные источники. Границы возможностей Gmail, Yahoo, Drive, Calendar и LinkedIn определяются руководствами соответствующих провайдеров.