Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [Bug]: The agent search does not match the question.

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

⚠️ Unknown tool 'github-auth' — sending error to model for self-correction (1/3)

Additional Logs / Traceback (optional)

Root Cause

Root Cause Analysis (optional)

Code Example

● 去年安全工单数量

Initializing agent...
────────────────────────────────────────

⚠️  Unknown tool 'github-auth' — sending error to model for self-correction (1/3)
  ┊ 📚 skills    list github  0.3s
  ┊ 📚 skill     github-auth  0.0s
  ┊ 💻 $         git --version && echo '---' && gh --version 2>/dev/null || echo 'gh not installed' && echo '---' && git config --global user.name 2>/dev/null || echo 'no git user.name configured' && git config --global user.email 2>/dev/null || echo 'no git user.email configured'  2.1s
  ┊ 💻 $         git config --global credential.helper 2>/dev/null || echo 'no git credential helper configured'  0.4s
  ┊ 💻 $         git config --global credential.helper store && echo 'Credential helper configured successfully'  0.4s

---
RAW_BUFFERClick to expand / collapse

Bug Description

Customizing the "text2sql" skill, when asking questions intelligently, there is a mismatch between the questions and the agent's search results.

Steps to Reproduce

question：去年安全问题数量

Customizing the "text2sql" skill：

name: text2sql description: | 从已配置数据库做取数、聚合、排行、时间对比与 ad-hoc SQL（报表/运营分析；典型域含工单、SR/CR、资产、采购库存、客户商机、财务与审计等落库表）。 英文 metrics、YoY、funnel、schema 等同类意图同理。不适用：纯网页调研、无表数据的写作或 UI。 version: 2.0.0 author: Hermes Agent license: MIT metadata: hermes: tags: [SQL, Database, Analytics, BI, ERP, ITSM] related_skills: [] prerequisites: commands: [python3]

Text to SQL（Hermes）

模型负责理解与写 SQL；本 skill 约定如何用 Hermes 自带库工具 完成问数。

要点

  • text2sql 是 skill，用 /text2sql、skill_view("text2sql") 或 --skills text2sql 加载。不要 function_call(name="text2sql")（会报 Unknown tool）。
  • 会话内问数请用 database_schema → 写只读 SQL → database_query（hermes-cli 且已配 DB_DSN 或 DB_TYPE+DB_HOST+DB_USERNAME+DB_PASSWORD 等，见 ~/.hermes/.env）。表名列名以 schema 为准，勿凭业务词硬猜。
  • 领域词多义时：先 schema / 轻量探测，再少量追问；勿用长问卷代替连库。
  • config.yaml 若配置了 skills 白名单，需包含 text2sql。

Expected Behavior

Use text2sql to generate SQL queries for the database.

Actual Behavior

text2sql did not find this skill.

Affected Component

CLI (interactive chat)

Messaging Platform (if gateway-related)

No response

Debug Report

● 去年安全工单数量

Initializing agent...
────────────────────────────────────────

⚠️  Unknown tool 'github-auth' — sending error to model for self-correction (1/3)
  ┊ 📚 skills    list github  0.3s
  ┊ 📚 skill     github-auth  0.0s
  ┊ 💻 $         git --version && echo '---' && gh --version 2>/dev/null || echo 'gh not installed' && echo '---' && git config --global user.name 2>/dev/null || echo 'no git user.name configured' && git config --global user.email 2>/dev/null || echo 'no git user.email configured'  2.1s
  ┊ 💻 $         git config --global credential.helper 2>/dev/null || echo 'no git credential helper configured'  0.4s
  ┊ 💻 $         git config --global credential.helper store && echo 'Credential helper configured successfully'  0.4s

Operating System

macos

Python Version

No response

Hermes Version

No response

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

No response

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

  • I'd like to fix this myself and submit a PR

extent analysis

TL;DR

The issue can be resolved by correctly loading the "text2sql" skill and ensuring the database connection is properly configured.

Guidance

  • Verify that the text2sql skill is loaded correctly using /text2sql, skill_view("text2sql"), or --skills text2sql, and not function_call(name="text2sql").
  • Check the config.yaml file to ensure that text2sql is included in the skills whitelist if it is configured.
  • Confirm that the database connection is properly set up by checking the ~/.hermes/.env file for DB_DSN or DB_TYPE, DB_HOST, DB_USERNAME, and DB_PASSWORD.
  • Use the database_schema to write SQL queries and then use database_query to execute them, ensuring that table and column names match the schema.

Example

No code snippet is provided as the issue does not require a specific code change, but rather a configuration and usage adjustment.

Notes

The provided debug report seems unrelated to the issue at hand, as it discusses an "Unknown tool 'github-auth'" which does not directly relate to the text2sql skill or its functionality. The actual issue seems to stem from a misconfiguration or misuse of the text2sql skill.

Recommendation

Apply workaround: Ensure correct loading and configuration of the text2sql skill and database connection, as the issue seems to be related to how the skill is being used rather than a problem with the skill itself.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#parallel task#integration issue#index setup#retrieval issue#search optimization

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix [Bug]: The agent search does not match the question.