# Hyperscaler Well-Architected guidance, for later workflows such as ALZ-F05 Target Architecture. # Holds Kyndryl's access, never a customer's. Store its connection tenant-wide. Queries come from fixed lists only. server_id: cloud-knowledge name: Cloud Knowledge description: Well-Architected guidance from each hyperscaler's own knowledge server, searched by fixed pillar and topic. version: 0.1.1 port: 8114 verify_tool: cloud_check_connection shared_code: - _common/tool_support.py - _common/knowledge_support.py extra_requirements: - boto3==1.43.122 connection_fields: - name: aws_access_key_id title: AWS access key ID description: Kyndryl's identity for the AWS MCP Server. required: false secret: false - name: aws_secret_access_key title: AWS secret access key description: Its secret key. required: false secret: true - name: google_api_key title: Google API key description: Kyndryl's key for the Developer Knowledge API. required: false secret: true tools: - name: cloud_check_connection display_name: Check connection description: Test that the knowledge servers answer. Sends no customer data. parameters: [] ai_implementation: | async def cloud_check_connection(arguments: Dict[str, Any]) -> Dict[str, Any]: results = {} connection = get_connection() for provider in KNOWLEDGE_SERVERS: try: await _knowledge_tools(provider, connection) results[provider] = "reachable" except Exception as error: results[provider] = type(error).__name__ return {"ok": all(v == "reachable" for v in results.values()), "message": json.dumps(results)} - name: cloud_search_well_architected display_name: Search Well-Architected guidance description: Search a hyperscaler's Well-Architected guidance by pillar and topic. Both come from fixed lists, so no customer detail can leave the platform. parameters: - name: provider type: string description: azure, aws or gcp. required: true - name: pillar type: string description: reliability, security, cost, operations, performance or sustainability. required: true - name: topic type: string description: One of the fixed topics; an invalid value lists them. required: true ai_implementation: | async def cloud_search_well_architected(arguments: Dict[str, Any]) -> Dict[str, Any]: provider, pillar, topic = arguments.get("provider"), arguments.get("pillar"), arguments.get("topic") if provider not in KNOWLEDGE_SERVERS: return _refuse("invalid_argument", "provider must be azure, aws or gcp") if pillar not in KNOWLEDGE_PILLARS: return _refuse("invalid_argument", "pillar must be one of: " + ", ".join(KNOWLEDGE_PILLARS)) if topic not in KNOWLEDGE_TOPICS: return _refuse("invalid_argument", "topic must be one of: " + ", ".join(KNOWLEDGE_TOPICS)) query = f"{KNOWLEDGE_SERVERS[provider]['framework']} {pillar} {topic}" try: results = await _knowledge_search(provider, get_connection(), query) except Exception as error: return _upstream_failed(provider, error) return {"success": True, "data": {"provider": provider, "pillar": pillar, "topic": topic, "results": results, "collected_at": _collected_at(), "evidence_ref": _evidence_ref("cloud_search_well_architected", arguments, results)}}