fix ssl

Author: yaozheng-fang

docs/docs/configuration.md

@@ -73,7 +73,8 @@ volcengine:
 |           | `DATABASE_OPENSEARCH_PORT`                  | OpenSearch 端口，默认 9200 |
 |           | `DATABASE_OPENSEARCH_USERNAME`              | OpenSearch 用户名 |
 |           | `DATABASE_OPENSEARCH_PASSWORD`              | OpenSearch 密码 |
-|           | `DATABASE_OPENSEARCH_CERT_PATH`             | OpenSearch 证书路径 |
+|           | `DATABASE_OPENSEARCH_CERT_PATH`             | OpenSearch 证书路径。**生产环境下建议通过证书访问。** |
+|           | `DATABASE_OPENSEARCH_USE_SSL`               | 是否启用 SSL 验证（`https`），默认 True |
 | MySQL     | `DATABASE_MYSQL_HOST`                       | MySQL 主机地址 |
 |           | `DATABASE_MYSQL_USER`                       | MySQL 用户名 |
 |           | `DATABASE_MYSQL_PASSWORD`                   | MySQL 密码 |

docs/docs/knowledgebase/overview.md

@@ -12,9 +12,9 @@ KnowledgeBase 在 veadk 框架中扮演 Agent 的外部知识库 角色。它像
 
 2. 后端抽象 (Backend Abstraction) ： KnowledgeBase 提供了一个统一的接口，屏蔽了底层向量数据库的实现细节。您只需要在初始化时通过 backend 参数指定使用 viking 还是 opensearch ，而无需关心它们各自的 API 调用方式。
 
-3) 知识检索 (Retrieval) ：当 KnowledgeBase 实例被传递给 Agent 后，Agent 会自动获得一个内置的 knowledgebase_search 工具。在回答问题时，Agent 可以自主决定是否使用此工具，将用户的问题转化为关键词去知识库中搜索相关信息，从而给出更精准、更具上下文的回答。
+3. 知识检索 (Retrieval) ：当 KnowledgeBase 实例被传递给 Agent 后，Agent 会自动获得一个内置的 knowledgebase_search 工具。在回答问题时，Agent 可以自主决定是否使用此工具，将用户的问题转化为关键词去知识库中搜索相关信息，从而给出更精准、更具上下文的回答。
 
-4) 与 Agent 无缝集成 ：通过在创建 Agent 时传入 knowledgebase=kb 参数，Agent 就能自动利用这个知识库来增强其回答能力。
+4. 与 Agent 无缝集成 ：通过在创建 Agent 时传入 knowledgebase=kb 参数，Agent 就能自动利用这个知识库来增强其回答能力。
 
 ## 使用方法
 
@@ -91,15 +91,13 @@ runner = Runner(agent, app_name="your_app_name")
 
 ![alt text](../assets/images/knowledge/image-8.png)
 
-
-
 6. 点击创建知识库按钮，点完后会有一个弹出问是否导入文档，选择暂不导入。
 ![alt text](../assets/images/knowledge/image-9.png)
 
 ![alt text](../assets/images/knowledge/image-10.png)
 
-
 ### TOS配置
+
 1. 登陆火山控制台进入TOS控制台
 ![alt text](../assets/images/knowledge/image-11.png)
 

veadk/configs/database_configs.py

@@ -30,6 +30,8 @@ class OpensearchConfig(BaseSettings):
 
     cert_path: str = ""
 
+    use_ssl: bool = True
+
     username: str = ""
 
     password: str = ""

veadk/knowledgebase/backends/opensearch_backend.py

@@ -99,7 +99,7 @@ def model_post_init(self, __context: Any) -> None:
                 self.opensearch_config.username,
                 self.opensearch_config.password,
             ),
-            use_ssl=True,
+            use_ssl=self.opensearch_config.use_ssl,
             verify_certs=False if not self.opensearch_config.cert_path else True,
             ca_certs=self.opensearch_config.cert_path,
             dim=self.embedding_config.dim,

veadk/memory/long_term_memory_backends/opensearch_backend.py

@@ -89,7 +89,7 @@ def _create_vector_index(self, index: str) -> VectorStoreIndex:
                 self.opensearch_config.username,
                 self.opensearch_config.password,
             ),
-            use_ssl=True,
+            use_ssl=self.opensearch_config.use_ssl,
             verify_certs=False if not self.opensearch_config.cert_path else True,
             ca_certs=self.opensearch_config.cert_path,
             dim=self.embedding_config.dim,