agents.json: 자연어를 통해 API와 상호 작용하는 인텔리전스를 위한 오픈 소스 사양

일반 소개

agents.json은 와일드카드 AI 팀이 개발한 오픈 소스 사양으로, 자연어를 통해 인텔리전스가 API와 효율적으로 소통할 수 있도록 하는 것을 목표로 하는 OpenAPI 표준을 기반으로 합니다. 구조화된 JSON 파일을 통해 인텔리전스와 API 간의 상호 작용 계약을 정의하고, 엔드포인트 검색 및 매개변수 생성을 최적화하며, 인텔리전스가 API를 호출할 때 발생하는 혼란스러운 순서와 낮은 정확도 문제를 해결합니다. 이 프로젝트는 0.1.0 버전으로 Apache 2.0 라이선스에 따라 GitHub(https://github.com/wild-card-ai/agents-json)에서 호스팅되며, 커뮤니티의 참여를 권장합니다. 개발자는 와일드카드 브리지 Python 패키지를 사용하여 에이전트.json 파일을 로드, 구문 분석 및 실행하여 다단계 API 호출을 쉽게 자동화할 수 있습니다.

Agents.json은 OpenAPI 표준에 기반하여 API와 AI 인텔리전스 상호 작용을 위한 계약을 공식적으로 설명하는 오픈 소스 JSON 사양입니다.

기능 목록

• 자연어 기반 API 호출인텔리전스는 일상 언어로 API 작업을 트리거합니다.
• OpenAPI 기반 확장 기능인텔리전스 사용을 최적화하기 위한 OpenAPI의 새로운 상호 작용 규칙.
• 작업 흐름 및 링크다단계 작업 흐름(플로우)과 작업 링크(링크)를 정의하여 통화 순서를 보장합니다.
• 상태 비저장 디자인기존 인프라 배포를 지원하기 위한 클라이언트 관리 상태.
• SDK 지원와일드카드 브리지는 사양 파일을 로드하고 실행하여 개발을 간소화합니다.

도움말 사용

액세스 및 준비

agents.json은 SDK와 함께 사용하거나 수동으로 작성해야 하는 사양 파일입니다. 작동 방식은 다음과 같습니다:

1. 에이전트.json 파일을 가져옵니다.

• 공식 예시::
  와일드카드 AI에서 다음과 같은 빠른 시작 노트북을 받으세요:
  • 다시 보내기:resend.ipynb
  • 스트라이프:single.ipynb
  • Google 스프레드시트 등multiple-dynamic.ipynb
• 사용자 지정 글쓰기::
  ground 전체 스키마파일을 생성합니다. 예를 들어

  {
  "apiVersion": "0.1.0",
  "baseUrl": "https://api.example.com",
  "chains": {
  "get_data": {
  "description": "获取指定数据",
  "agent_instructions": "根据用户输入提取数据",
  "steps": [{"endpoint": "/data", "method": "GET"}]
  }
  }
  }

를 배치하는 것이 좋습니다. /.well-known/agents.json 지식인이 쉽게 발견할 수 있는 경로를 제공합니다.

2. 와일드카드 브리지 설치

• 요청Python 3.10 이상.
• 이동::
  1. 실행 명령을 실행합니다:

     pip install wildcard-bridge
     

  2. 유효성 검사:

     python -c "import wildcard_bridge; print(wildcard_bridge.__version__)"
     

3. 구성 환경

• 인증 지원기본, ApiKey 및 무기명 인증이 지원됩니다. 예시:

  from wildcard_bridge import Bridge
  bridge = Bridge(auth={"type": "ApiKey", "key": "your-api-key"})
  

• 커넥티드 인텔리전스지원되는 LLM(예: OpenAI)에 액세스하고 기본 프롬프트를 준비합니다.

주요 기능의 작동

기능 1: 사양 파일 로드 및 구문 분석

• 이동::
  1. 파일을 로드합니다:

     bridge.load_agents_json("path/to/agents.json")
     

  2. 작업 체인을 봅니다:

     chains = bridge.get_available_chains()
     print(chains)  # 输出可用任务，如 ["get_data"]
     

• 사용지원되는 작업 이해, 실행 준비 완료.

기능 2: 작업 흐름 실행

• 이동::
  1. 작업을 실행합니다:

     result = bridge.run_chain("get_data", {"query": "sales report"})
     print(result)  # 输出 API 返回结果
     

  2. 반환 데이터를 확인합니다.
• take사용자가 "판매 보고서 줘"라고 말하면 스마트 바디가 자동으로 API를 호출합니다.

기능 3: 디버깅 및 최적화

• 테스트 중 구성 요소 조정::

  bridge.enable_debug()
  result = bridge.run_chain("get_data", {"query": "test"})
  

  로그를 확인하여 각 단계가 올바른지 확인하세요.

• 최적화: 조정 agent_instructions 또는 인텔리전스의 정확도를 높이기 위한 예제입니다.

주요 기능 작동

작업 흐름 및 링크 디자인

• 워크플로::
  1. Gmail 답장 등의 다단계 작업 흐름을 정의하세요:

     {
     "chains": {
     "reply_email": {
     "description": "回复邮件",
     "agent_instructions": "根据用户输入回复邮件",
     "steps": [
     {"endpoint": "/threads/{threadId}", "method": "GET"},
     {"endpoint": "/messages/send", "method": "POST"}
     ]
     }
     }
     }
     

  2. 실행 중입니다:

     bridge.run_chain("reply_email", {"threadId": "123", "reply": "已收到"})
     

• 밝은 지점흐름과 링크는 호출이 올바른 순서로 이루어지도록 보장하며 인텔리전스는 호출에 대해 추론할 필요가 없습니다.

기존 시스템과의 상태 비저장 호환성

• 실현::
  SDK는 클라이언트 측에서 실행되며 서버리스 환경에 맞게 조정됩니다:

  def lambda_handler(event, context):
  bridge = Bridge(auth={"type": "Bearer", "token": event["token"]})
  bridge.load_agents_json("s3://bucket/agents.json")
  return bridge.run_chain("task", event["args"])
  

• 최첨단API 서버를 변경할 필요 없이 그냥 사용하세요.

예: 스트라이프 결제 문의

• agents.json::

  {
  "baseUrl": "https://api.stripe.com/v1",
  "chains": {
  "check_payment": {
  "description": "查询支付状态",
  "agent_instructions": "根据支付 ID 返回状态",
  "steps": [{"endpoint": "/charges/{chargeId}", "method": "GET"}]
  }
  }
  }
  

• 움직여야 합니다.::

  result = bridge.run_chain("check_payment", {"chargeId": "ch_123"})
  print(result)
  

• 효과스마트 바디가 결제 상태를 직접 반환하므로 간편하고 효율적입니다.

주의

• 보증인키는 유출을 방지하기 위해 환경 변수에 저장됩니다.
• 커뮤니티: 가입 불화 지원 받기.
• (컴퓨터) 파일참조 공식 문서.