AgentSkillsCN

agentapi-proxy-api

通过API Key认证方式与agentapi-proxy API交互，实现会话管理功能。 当您需要：(1) 创建新的agentapi会话；(2) 搜索并列出现有会话；(3) 删除会话；(4) 将请求路由至特定会话实例；(5) 管理会话共享；(6) 访问用户设置与通知时，可使用此技能。该技能支持多种认证方式，包括静态API Key（通过X-API-Key头部传递）以及Authorization Bearer令牌。 注意：如需进行日程管理，请改用“日程管理”技能。

SKILL.md
--- frontmatter
name: agentapi-proxy-api
description: |
  Interact with agentapi-proxy API using API Key authentication for session management.
  Use when you need to: (1) Create new agentapi sessions, (2) Search and list existing sessions,
  (3) Delete sessions, (4) Route requests to specific session instances, (5) Manage session sharing,
  (6) Access user settings and notifications. Supports multiple authentication methods including
  static API keys (X-API-Key header) and Authorization Bearer tokens.
  Note: For schedule management, use the schedule-management skill instead.

agentapi-proxy API

This skill provides guidance for interacting with the agentapi-proxy API using API Key authentication.

Authentication

agentapi-proxy supports multiple authentication methods. The most common are:

Method 1: X-API-Key Header (Recommended)

bash
curl -H "X-API-Key: YOUR_API_KEY" https://api.example.com/endpoint

Method 2: Authorization Bearer Token

bash
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.example.com/endpoint

Core Workflows

Creating a Session

bash
curl -X POST https://api.example.com/start \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": {
      "GITHUB_TOKEN": "ghp_...",
      "CUSTOM_VAR": "value"
    },
    "tags": {
      "repository": "my-repo",
      "branch": "main"
    }
  }'

Response:

json
{
  "session_id": "550e8400-e29b-41d4-a716-446655440000"
}

Searching Sessions

bash
# List all sessions
curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.example.com/search

# Filter by status
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.example.com/search?status=active"

# Filter by tags
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.example.com/search?tag.repository=my-repo&tag.branch=main"

Deleting a Session

bash
curl -X DELETE https://api.example.com/sessions/SESSION_ID \
  -H "X-API-Key: YOUR_API_KEY"

Routing to Session

All requests to /:sessionId/* are proxied to the agentapi instance for that session:

bash
curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.example.com/SESSION_ID/message \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello", "type": "user"}'

API Reference

For complete API endpoint documentation, permissions, and authentication details, see:

Helper Scripts

Use scripts/agentapi_request.sh for quick API requests with automatic environment variable handling.