Skip to main content

​
Methods

Get an agent skill artifact by its ID.

​
Parameters

​
agent_skill_id
str
required

​
Returns

​
GetAgentSkillResponse
GetAgentSkillResponse
🔗 GetAgentSkillResponseSuccessful Response

​
Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.agent_skills.get(
    agent_skill_id="value",
)
Delete an agent skill artifact by its ID.

​
Parameters

​
agent_skill_id
str
required

​
Returns

​
EmptyResponse
EmptyResponse
🔗 EmptyResponseSuccessful Response

​
Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.agent_skills.delete(
    agent_skill_id="value",
)
List agent skills with optional filtering by FQN, ML Repo, or name. When present, latest_version.manifest.source is blob-storage with description only; use GET agent skill version for full SKILL.md (inline source with skill_md).

​
Parameters

​
fqn
typing.Optional[str]
Fully qualified name to filter agent skills by (format: ‘agent_skill://’)
​
ml_repo_id
typing.Optional[str]
ML Repo ID filter
​
name
typing.Optional[str]
Agent skill name filter
​
offset
typing.Optional[int]
Pagination offset
​
limit
typing.Optional[int]
Page size
​
include_empty_agent_skills
typing.Optional[bool]
Whether to include agent skills that have no versions

​
Returns

​
SyncPager[AgentSkill, ListAgentSkillsResponse]
SyncPager[AgentSkill, ListAgentSkillsResponse]
🔗 ListAgentSkillsResponseSuccessful Response

​
Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.agent_skills.list(
    fqn="value",
    ml_repo_id="value",
    name="value",
    offset=10,
    limit=10,
    include_empty_agent_skills="value",
)

# Iterate through results
for item in response:
    print(item.name)

# Or paginate page by page
for page in response.iter_pages():
    for item in page:
        print(item.name)
Create or update an agent skill version from a manifest.

​
Parameters

​
manifest
AgentSkillManifest
required
🔗 AgentSkillManifestManifest containing metadata for the agent skill to apply

​
Returns

​
GetAgentSkillVersionResponse
GetAgentSkillVersionResponse
🔗 GetAgentSkillVersionResponseThe created or updated agent skill version

​
Usage

from truefoundry import TrueFoundry

client = TrueFoundry(
    api_key="YOUR_API_KEY",
    base_url="https://yourhost.com/path/to/api",
)

client.agent_skills.create_or_update(
    manifest={"key": "value"},
)