Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Anna OpenAI Agents SDK -agentille Instagram-, TikTok- ja WhatsApp-työkalut

OpenAI Agents SDK -agentti saa Instagram-, TikTok-, WhatsApp- ja muut kanavat työkaluina MCPServerStreamableHttp-luokan kautta, joka osoittaa osoitteeseen https://easycoexistence.com/api/mcp. Todennuskäsittelijänä toimii MCP Python SDK:n OAuthClientProvider. Työkalusuodatin rajaa yli 35+ työkalua tehtävään, require_approval pitää julkaisut pidossa, kunnes henkilö hyväksyy ne, ja jokainen kutsu kulkee verkkoon kunkin alustan virallisen API:n kautta.

httpx2.Auth

Mitä MCPServerStreamableHttp ottaa kohdassa params["auth"] MCP Python SDK v2:n kanssa; v1:n kanssa se ottaa httpx.Auth-olion.

mcp>=1.19.0,<3

Agents SDK:n riippuvuutena oleva mcp-paketin versioalue, joka kattaa molemmat MCP Python SDK:n pääversiot.

interruptions

Mistä keskeytynyt ajo listaa hyväksyntää odottavat työkalukutsut, joita RunState hyväksyy tai hylkää ennen kuin Runner.run jatkaa.

Per request

Kuinka usein Responses API:n MCP-työkalulle on lähetettävä OAuth-token authorization-kentässä; OpenAI ei tallenna arvoa.

40 a minute

Kuinka monta kutsua TikTok sallii valtuutettua tiliä kohden kullakin Accounts API -päätepisteellä, kommenttivastaukset mukaan lukien.

Miten Agents SDK -agentti yhdistyy easyCoexistenceen?

MCPServerStreamableHttp-luokan kautta, ja params["auth"]-kentässä on MCP Python SDK:n OAuthClientProvider. Agents SDK välittää tämän käsittelijän rakentamalleen HTTP-asiakkaalle, joten provider löytää easyCoexistencen valtuutuspalvelimen, rekisteröi agenttisi julkisena asiakkaana, suorittaa kerran selaimessa tapahtuvan kirjautumisen PKCE:llä ja uusii tunnin mittaiset käyttötokenit refresh-tokenilla. Esimerkki käyttää MCP Python SDK v2:ta, jossa käsittelijän on oltava httpx2.Auth, ja provider on sellainen. Tallennusobjekti säilyttää rekisteröinnin ja tokenit ajojen välillä; alla oleva tiedosto korvaa salaisuuksien tallennuspaikan. create_static_tool_filter listaa työkalut, jotka agentti saa nähdä, ja require_approval nimeää ne, jotka odottavat henkilön hyväksyntää.

The MCP server, signed in over OAuth, with a filter and approvals
import json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse

from pydantic import AnyUrl
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
from agents.mcp import MCPServerStreamableHttp, create_static_tool_filter

URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json")  # a secret store in production

class SavedSignIn:  # the MCP SDK's TokenStorage: registration and tokens survive restarts
    def _read(self) -> dict:
        return json.loads(SAVED.read_text()) if SAVED.exists() else {}
    def _write(self, key: str, model) -> None:
        data = self._read()
        data[key] = model.model_dump(mode="json")
        SAVED.write_text(json.dumps(data))
    async def get_tokens(self):
        t = self._read().get("tokens")
        return OAuthToken(**t) if t else None
    async def set_tokens(self, tokens): self._write("tokens", tokens)
    async def get_client_info(self):
        c = self._read().get("client")
        return OAuthClientInformationFull(**c) if c else None
    async def set_client_info(self, info): self._write("client", info)

async def open_sign_in(url: str) -> None:
    webbrowser.open(url)

async def code_from_redirect() -> AuthorizationCodeResult:
    q = parse_qs(urlparse(input("Address after sign-in: ")).query)
    return AuthorizationCodeResult(code=q["code"][0], state=q["state"][0])

oauth = OAuthClientProvider(
    server_url=URL,
    client_metadata=OAuthClientMetadata(
        client_name="Social desk agent",  # shown on easyCoexistence's consent screen
        redirect_uris=[AnyUrl("http://localhost:3030/callback")],
        scope="mcp",
    ),
    storage=SavedSignIn(),
    redirect_handler=open_sign_in,
    callback_handler=code_from_redirect,
)

PUBLISH = ["publish_instagram_post", "publish_tiktok_post", "publish_facebook_post"]

def easycoexistence() -> MCPServerStreamableHttp:
    return MCPServerStreamableHttp(
        name="easyCoexistence",
        params={"url": URL, "auth": oauth, "timeout": 60},
        client_session_timeout_seconds=60,  # publishing waits on the network's API
        cache_tools_list=True,
        tool_filter=create_static_tool_filter(allowed_tool_names=[
            "list_social_accounts", "list_social_posts", "list_social_comments",
            "reply_to_comment", "list_scheduled_posts", *PUBLISH,
        ]),
        require_approval={"always": {"tool_names": PUBLISH}},
    )

Miten julkaisu pidetään henkilön hyväksynnän takana?

require_approval-asetuksella palvelimella, joka pysäyttää ajon ennen nimetyn työkalun suorittamista. Ajo palauttaa silloin keskeytykset lopullisen vastauksen sijaan: muunna tulos RunState-olioksi, hyväksy tai hylkää jokainen odottava kutsu ja kutsu Runner.run uudelleen samalla agentilla ja tilalla. Kun always_approve jätetään arvoon False, jokainen kyllä kattaa yhden kutsun, joten agentti ei voi käyttää samaa hyväksyntää toiseen julkaisuun. Palvelin pysyy auki tauon yli, koska silmukka kulkee sen async with -lohkon sisällä. Jos tarkastus kestää tunteja, SDK voi tallentaa tilan JSON-muodossa ja ladata sen myöhemmin RunState.from_json-funktiolla.

Run the agent and resume it after each decision
from agents import Agent, Runner

RULES = "You run Acme's social accounts. Schedule posts with scheduled_at; TikTok replies are public."

async def run(task: str) -> str:
    async with easycoexistence() as server:
        agent = Agent(name="Social desk", instructions=RULES, mcp_servers=[server])
        result = await Runner.run(agent, task)
        while result.interruptions:  # a publish tool is waiting for a decision
            state = result.to_state()
            for item in result.interruptions:
                if await ask_a_person(item):  # your review screen, chat message or queue
                    state.approve(item, always_approve=False)
                else:
                    state.reject(item)
            result = await Runner.run(agent, state)
        return result.final_output

Miten TikTok-kommentti tai Instagram-yksityisviesti käynnistää ajon?

Oman HTTPS-reitin kautta, sillä agentti kuulee vain sen, mitä pyytää MCP-palvelimelta. set_social_webhook_destination ohjaa tilin kommentit, maininnat ja yksityisviestit reitille ja palauttaa allekirjoitusavaimen kerran; TikTok-tilit välittävät kommentit. Reitti tarkistaa X-EC-Signature-otsikon, HMAC-SHA256-tiivisteen aikaleimasta, pisteestä ja raakarungosta, vastaa easyCoexistencen 8 sekunnin aikarajan sisällä ja jonottaa tapahtuman. Työntekijä kutsuu sitten Runner.run-funktiota tapahtuma syötteenä. Yksityisviesteissä tili ja lähettäjä muodostavat istunnon, joka pitää keskustelun yllä. TikTok-kommentti tarvitsee vain kommentin ja sen videon, joten se voi toimia ilman istuntoa.

Mitä agentin ohjeissa pitäisi sanoa kustakin verkosta?

Säännöt, jotka kunkin verkon API soveltaa tiliin, kirjoitettuna kohtaan, jonka malli lukee:

  • TikTok: reply_to_comment julkaisee julkisesti ja tarvitsee videon tunnuksen post_id-kenttään; send_social_dm hylkää TikTok-tilit.
  • TikTok-volyymi: enintään 40 kutsua minuutissa tiliä kohden vastauspäätepisteellä, ja monta lähes samanlaista vastausta lyhyessä ajassa voidaan piilottaa roskapostina.
  • Instagram-yksityisviestit: vastauksia vain ihmisille, jotka ovat kirjoittaneet viimeisen 24 tunnin aikana, enintään 1,000 tavua UTF-8-tekstiä.
  • WhatsApp: send_message 24 tunnin sisällä asiakkaan viimeisimmästä viestistä, muulloin send_template hyväksytyllä viestipohjalla.
  • Ajoitus: scheduled_at hyväksyy ISO 8601 -muodon aikavyöhykkeellä, 1 minuutista 90 päivään eteenpäin, ja list_scheduled_posts näyttää jonon.

Voiko agentti käyttää HostedMCPTool-työkalua tai toimia ilman kirjautumista?

Molempia, kompromisseineen. HostedMCPTool luovuttaa palvelimen Responses API:lle, jonka MCP-työkalu ottaa OAuth-käyttötokenin authorization-kentässä ja tarvitsee sen jokaisessa pyynnössä, koska OpenAI ei tallenna sitä; easyCoexistencen käyttötoken on voimassa tunnin, joten koodisi uusii sen ennen jokaista ajoa. Työhön, jossa ei ole ketään kirjautumassa, ohita MCP: funktiotyökalut, jotka kutsuvat Partner API:a ec_live_-avaimella, voivat jonottaa julkaisuja reitillä POST /api/v1/channels/:id/posts ja hakea tuoreet TikTokin, YouTuben ja LinkedInin tokenit reitiltä GET /api/v1/channels/:id?credentials=1, kun taas kommenttisäännöt ja automaatiot vastaavat easyCoexistencessä ilman, että agentti on käynnissä.

Yleiset virheet

  • 5 sekunnin client_session_timeout_seconds-arvon jättäminen ennalleen julkaisuihin. Julkaisu odottaa verkon API:n vastausta, joten hidas kutsu voi aikakatkaistua agentissa sen jälkeen, kun easyCoexistence on jo välittänyt julkaisun eteenpäin; anna minuutti ja tarkista list_scheduled_posts ennen uutta yritystä.
  • external_id:n antaminen account_id:n tilalle. Työkalut ottavat account_id:n, easyCoexistencen tunnuksen tilille; external_id on tilin oma tunnus Instagramissa, TikTokissa tai Facebookissa.
  • Keskeytysten hyväksyminen silmukassa ilman ihmistä. require_approval suojaa julkaisuja vain silloin, kun ihminen tai sinun luottamasi sääntö päättää jokaisesta odottavasta kutsusta.
  • Agentille tilin oman toiminnan syöttäminen. Instagram palauttaa tilin yksityisviestit kaikuina, joissa is_echo on true, ja sen julkiset vastaukset uusina kommentteina; suodata molemmat pois ennen Runner.run-kutsua.
Näin teet tämän EasyCoexistencen avulla

easyCoexistence antaa OpenAI Agents SDK -agenteillesi ulottuvuuden asiakkaisiin WhatsAppissa, Instagramissa, Facebookissa, TikTokissa, YouTubessa, LinkedInissä ja muissa kanavissa, kukin virallisen API:nsa kautta: MCP-palvelin, joka kirjautuu OAuthilla, allekirjoitetut tapahtumat kommenteille ja yksityisviesteille sekä Partner API tehtäville, jotka ajetaan ilman ihmisen valvontaa, ja jokaista yhteyttä valvotaan ympäri vuorokauden. US$ 9:stä US$ 0.75:een yhteydeltä kuukaudessa, ja hinta laskee lisättäessä yhteyksiä. Ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Tarvitseeko agentti API-avaimen easyCoexistencestä?

Ei MCP:n kautta. OAuth-kirjautuminen antaa agentille omat tokenit; hallintapaneelin ec_live_-avain on tarkoitettu vain koodille, joka kutsuu Partner API:a MCP-palvelimen sijaan.

Voiko sama agentti vastata WhatsApp-viesteihin?

Kyllä, numeron työkaluilla: list_numbers antaa connection_id-tunnuksen, send_message 24 tunnin sisällä asiakkaan viimeisimmästä viestistä ja send_template sen ulkopuolella. OpenAI Agents SDK:n WhatsApp-opas kattaa viestien vastaanottamisen.

Mitä mallia agentti käyttää?

Sitä, jonka annat Agent-oliolle. MCP-työkalut toimivat samalla tavalla mallista riippumatta, mallin käytön laskuttaa sen palveluntarjoaja, ja easyCoexistence veloittaa yhteyttä kohden.

Paljonko easyCoexistence maksaa OpenAI Agents SDK -agentille?

US$ 9:stä US$ 0.75:een yhteydeltä kuukaudessa, hinnan laskiessa lisättäessä yhteyksiä, sama jokaisessa verkossa. MCP-palvelin, välitetyt tapahtumat ja Partner API kuuluvat hintaan, ja ensimmäiset 3 päivää ovat ilmaisia.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu