feat: add AgentRequest.config property for automatic FC credential extraction

Users can now access request.config directly instead of manually calling
Config.from_request_headers(request). Updated example to use the property.

Change-Id: Ib2e4e7ace6cd043a2d3fe651c7fbd1bc25648cde
Co-developed-by: Claude <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: congxiao-wxx

agentrun/server/model.py

@@ -14,7 +14,6 @@
     Iterator,
     List,
     Optional,
-    TYPE_CHECKING,
     Union,
 )
 
@@ -379,6 +378,20 @@ class AgentRequest(BaseModel):
         None, description="原始 HTTP 请求对象（Starlette Request）"
     )
 
+    @property
+    def config(self):
+        """从请求头提取 FC 临时凭证构造 Config / Extract FC credentials from request headers
+
+        FC 平台在每次请求时通过 header 注入最新的 STS 临时凭证，
+        可直接传给 KnowledgeBase、Sandbox 等资源类的 config 参数。
+
+        Returns:
+            Config: 包含请求头中凭证信息的配置对象
+        """
+        from ..utils.config import Config
+
+        return Config.from_request_headers(self)
+
 
 # ============================================================================
 # OpenAI 协议配置（前置声明）

examples/server_with_header_credentials.py

@@ -26,23 +26,20 @@
 from agentrun.knowledgebase import KnowledgeBase
 from agentrun.server import AgentRequest, AgentRunServer
 from agentrun.server.model import ServerConfig
-from agentrun.utils.config import Config
 from agentrun.utils.log import logger
 
 KNOWLEDGE_BASE_NAME = os.getenv("AGENTRUN_KNOWLEDGE_BASE", "my-knowledge-base")
 
 
 async def invoke_agent(request: AgentRequest):
-    config = Config.from_request_headers(request)
-
     user_query = request.messages[-1].content if request.messages else ""
     if not user_query:
         yield "请输入您的问题。"
         return
 
     try:
-        kb = KnowledgeBase.get_by_name(KNOWLEDGE_BASE_NAME, config=config)
-        result = kb.retrieve(query=user_query, config=config)
+        kb = KnowledgeBase.get_by_name(KNOWLEDGE_BASE_NAME, config=request.config)
+        result = kb.retrieve(query=user_query, config=request.config)
 
         nodes = result.get("nodes", result.get("data", []))
         if not nodes:

tests/e2e/test_header_credentials.py

@@ -12,6 +12,8 @@
 from agentrun.utils.config import Config
 
 
+
+
 def _make_client(invoke_agent):
     server = AgentRunServer(invoke_agent=invoke_agent)
     app = server.as_fastapi_app()
@@ -165,3 +167,32 @@ async def invoke_agent(request: AgentRequest):
         assert captured["ak"] == "header-ak"
         assert captured["sk"] == "header-sk"
         assert captured["token"] == "header-token"
+
+    def test_request_config_property(self):
+        """AgentRequest.config 属性直接返回从 header 提取的 Config"""
+        captured = {}
+
+        async def invoke_agent(request: AgentRequest):
+            config = request.config
+            captured["ak"] = config.get_access_key_id()
+            captured["sk"] = config.get_access_key_secret()
+            captured["token"] = config.get_security_token()
+            yield "ok"
+
+        client = _make_client(invoke_agent)
+        response = client.post(
+            "/openai/v1/chat/completions",
+            json={
+                "messages": [{"role": "user", "content": "test"}],
+                "stream": True,
+            },
+            headers={
+                "x-fc-access-key-id": "ak-prop-test",
+                "x-fc-access-key-secret": "sk-prop-test",
+                "x-fc-security-token": "token-prop-test",
+            },
+        )
+        assert response.status_code == 200
+        assert captured["ak"] == "ak-prop-test"
+        assert captured["sk"] == "sk-prop-test"
+        assert captured["token"] == "token-prop-test"