[2026-06-21] eagle: family/how-to/htpc-emulators-setup.md personal/projects/balda/balda-valera.md personal/projects/hermes/hermes-gateway-stream-consumer-text-loss.md personal/projects/hermes/no-edit-segment-send-bug.md

2026-06-21 11:26:20 +06:00
parent ab6d1ba5c3
commit 7f6c941ad9
4 changed files with 347 additions and 0 deletions
@@ -50,6 +50,66 @@ runtime:

 Раньше не работало — исправлено в upstream `32e33a8 fix: support hosted MCP toolsets` / `d774c78 fix: use hosted llmagent sessions`.

+## Проблема: MCP не работают у Валеры (provider: type=openai)
+
+### Коренная причина
+hostedagent (`pkg/runtime/hostedagent/`) не поддерживает MCP инструменты.
+`openAIConstructor` в `agentfactory.go` получает `resolvedMCP map[string]agentconfig.MCPServerConfig`,
+но не передаёт их в `hostedagent.Config` — у Config нет поля для MCP.
+`openAIConstructor` вызывает `newHostedAgent(hostedagent.Config{...})` без MCPServers.
+
+Фикс: в `hostedagent.Config` добавить `MCPServers map[string]agentconfig.MCPServerConfig`,
+а в `openAIConstructor` передавать `toRuntimeMCPServers(resolvedMCP)`.
+
+Важно: hostedagent использует OpenAI-compatible API (не ACP). MCP инструменты нужно
+интегрировать через OpenAI tool_calls — модель шлёт tool_call, код выполняет MCP вызов.
+
+## Проблема: MCP не работают у Валеры — попытка фикса
+
+### Что было сделано (2026-06-19)
+
+#### 1. go.mod
+Добавлен `replace github.com/normahq/norma => ../norma-local` — для локальной разработки.
+
+#### 2. hostedagent — добавлена поддержка MCP
+- `pkg/runtime/hostedagent/agent.go`:
+  - В Config добавлено `MCPServers map[string]acpagent.MCPServerConfig`
+  - Сохранено в `runtimeAgent`
+  - В `run()`: после создания модели вызывается `model.SetTools(openAIToolsFromMCPServers(r.MCPServers))`
+
+- `pkg/runtime/hostedagent/openai.go`:
+  - В `openAIChatRequest` добавлено `Tools []openAIToolDefinition`
+  - В `OpenAIModel` добавлены `tools []openAIToolDefinition + `SetTools()`
+  - Добавлен `tool_calls` в парсинг ответа (`tool_calls` → content string)
+
+#### 3. agentfactory — передача MCP
+- В `openAIConstructor` добавлено `MCPServers: toRuntimeMCPServers(resolvedMCP)` в вызов `newHostedAgent()`
+
+#### 4. Dockerfile
+В `Dockerfile.claudio` добавлен `COPY norma-local/ ./norma-local/` — чтобы `replace` работал в контейнере.
+
+#### 5. Сборка
+Образ собран и запущен как `balda-agent-valera:latest`.
+
+#### 6. Диагностика
+- `mcpServerIDs` приходят корректно: `[balda obsidian fast-rlm]`
+- Добавлен stderr-лог в `agentfactory.go` в `Build()`:
+  ```go
+  fmt.Fprintf(os.Stderr, "BALDA-DEBUG: mcpServerIDs=%v resolvedMCP=%v\n", mcpServerIDs, resolvedMCP)
+  ```
+- Для просмотра логов нужен `docker logs balda-agent-valera-1 2>&1 | grep BALDA-DEBUG`
+
+### Почему не заработало
+Точная причина не установлена — нужно увидеть `resolvedMCP` в логах контейнера. Возможные варианты:
+- `resolveMCPServers` возвращает пустой map
+- `toRuntimeMCPServers` неправильно конвертирует
+- `SetTools` не влияет на уже созданные сообщения в сессии
+
+### Что осталось
+1. Прочитать stderr из контейнера: `docker logs balda-agent-valera-1 2>&1 | grep BALDA-DEBUG`
+2. Если `resolvedMCP` пустой — исправлять цепочку resolveMCPServers
+3. Если не пустой — тестировать response с tool_calls в DeepSeek ответе
+
 ## Диагностика молчания

 ### 1. MCP ошибка: `failed to list MCP tools: failed to connect: Not Found`