关于 connection-manager
Connection Manager 是用于浏览和管理 Lytics 外部系统连接及认证提供方的技能,面向需要配置集成的用户。它通过 Lytics API 查询连接、认证和可用提供方,并要求写操作经过确认。
主要功能
- 01列出并查看连接
- 02列出并查看认证提供方
- 03查询可用集成类型
- 04按流程发现连接数据与架构
- 05写操作前要求确认并保护凭据
适用场景
- 01检查现有外部系统连接
- 02查找集成提供方并配置认证
- 03扫描连接以查看可用数据和架构
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ lytics/ agent-skills --skill connection-manager安装后在 Claude Code 中输入/connection-manager确认已加载。
详细介绍
连接管理器
用途
浏览和管理连接(外部系统配置)及身份验证提供方(凭据/令牌)。连接定义了 Lytics 如何与外部平台通信。
环境
需要经过身份验证的 API 访问权限。凭据解析方式请参阅 ../references/auth.md。
API 端点
连接
# List all connections
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Get connection
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Create connection
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection" \
-H "Authorization: ${LYTICS_API_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ ... connection config ... }'
# Update connection
curl -s -X PUT "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}" \
-H "Authorization: ${LYTICS_API_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ ... updated config ... }'
# Delete connection
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Scan connection (discover available data)
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}/scan" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Get connection schema
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}/schema" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Get connection table schema
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection/${CONNECTION_ID}/schema/${TABLE}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
身份验证提供方
# List all auth providers
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Get auth by ID
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${AUTH_ID}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Get auth by type and ID
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${TYPE}/${AUTH_ID}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
# Create auth
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${TYPE}" \
-H "Authorization: ${LYTICS_API_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ ... auth credentials ... }'
# Update auth
curl -s -X PUT "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${TYPE}/${AUTH_ID}" \
-H "Authorization: ${LYTICS_API_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ ... updated credentials ... }'
# Delete auth
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth/${AUTH_ID}" \
-H "Authorization: ${LYTICS_API_TOKEN}"
提供方(可用的集成类型)
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/provider" \
-H "Authorization: ${LYTICS_API_TOKEN}"
行为
读取操作(list、get、scan)
立即执行。以表格形式显示连接,包含:
- 连接 ID、名称、类型、状态、上次使用时间
写入操作(create、update、delete)
使用确认门控模式。身份验证凭据属于敏感信息——切勿记录或显示完整的凭据值。
连接发现流程
设置新集成时:
- 列出可用的提供方(
GET /v2/provider) - 为选定的提供方创建身份验证
- 使用该身份验证创建连接
- 扫描连接以发现可用数据
- 查看连接架构
错误处理
- 身份验证已过期:建议重新创建身份验证提供方
- 连接测试失败:检查身份验证凭据和网络访问权限
- 未找到提供方:列出可用的提供方
依赖项
- 使用:
../references/auth.md、../references/api-client.md、../references/confirmation-gate.md
评论
支持 Markdown