A2A

할 수 있는 일

외부 에이전트가 A2A 프로토콜(JSON-RPC)로 Tello 에이전트를 호출하게 연결해요. Agent Card로 기능 명세를 조회하고 message/send로 메시지를 보내요. 발급한 키마다 연결할 에이전트를 지정할 수 있어요.

A2A Endpoint

https://api.telloai.io

시작하기 전에

포털 로그인이 필요해요. 키에 에이전트를 연결하려면 에이전트를 먼저 만들어 두면 선택할 수 있어요(연결은 선택이에요).

사용 방법

포털 A2A 화면 위쪽의 A2A Endpoint와 Agent Card 주소를 복사해요. + 새 Key 발급에서 키 이름과 연결 에이전트(선택)를 정해 발급해요. 발급된 키의 연결 에이전트는 목록의 드롭다운에서 언제든 바꿀 수 있어요. 인증은 Authorization: Bearer <A2A_KEY> 헤더를 써요.

Agent Card

에이전트의 능력·엔드포인트 정보는 well-known 경로에 있어요.

curl "https://api.telloai.io/.well-known/agent-card.json" \
  -H "Authorization: Bearer <YOUR_A2A_KEY>"

메시지 전송

message/send 메서드로 작업을 넘겨요.

curl -X POST "https://api.telloai.io" \
  -H "Authorization: Bearer <YOUR_A2A_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{ "kind": "text", "text": "예약 확인 전화를 걸어줘" }],
        "messageId": "msg-1"
      }
    }
  }'

필드	설명
`jsonrpc`	고정값 `"2.0"`
`id`	요청 식별자
`method`	`message/send`
`params.message.role`	`user`
`params.message.parts`	`{ kind, text }` 배열
`params.message.messageId`	메시지 식별자

실제 통화가 발신돼요. 통제된 테스트 수신번호로만 시험하세요.

주의사항

전체 키는 발급 직후 한 번만 볼 수 있어요. 분실하면 폐기 후 재발급해요.
연결 에이전트는 에이전트 미지정으로 둘 수도 있어요.
폐기하면 즉시 사용할 수 없어요.
A2A 도구를 도구 관리에 등록할 때 서버가 Agent Card를 자동 조회하지 않아요. 이름·설명·인증을 직접 입력해요.

시작하기

홈

에이전트

전화 & 통화

개발자 연동

설정

할 수 있는 일

시작하기 전에

사용 방법

Agent Card

메시지 전송

주의사항

관련 문서

​할 수 있는 일

​시작하기 전에

​사용 방법

​Agent Card

​메시지 전송

​주의사항

​관련 문서

할 수 있는 일

시작하기 전에

사용 방법

Agent Card

메시지 전송

주의사항

관련 문서