Adoteca — Adoção de Pets no Brasil
Cães e gatos para adoção no Brasil, de ONGs e protetores. Busque por cidade, porte, idade e saúde.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Befunde (5)
- HIGHTool poisoning patterns detected
- MEDIUMTool 'search_pets' description contains placeholder textin search_pets
- LOWTool 'get_pet_details' description lacks action verbin get_pet_details
- LOWTool 'get_rescuer_details' description lacks action verbin get_rescuer_details
- INFOTool description contains placeholder or incomplete textin search_pets
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~16,649Tokens (Tool-Definitionen)
~17.3 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (13.01% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"adoteca": {
"url": "https://api.adoteca.com.br/mcp"
}
}
}Remote-Endpunkte
https://api.adoteca.com.br/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (10)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢search_pets(species, city, state, size, sex, ...)
Busca em TODO o catálogo de cães e gatos para adoção no Brasil, por filtros como cidade, espécie, porte e idade, ou pelo nome do pet. É a busca padrão de quem quer adotar. Inclui pets já adotados: leia `status` e só ofereça os 'available'. Mostre o `adoption_url` e nunca invente pets.
Eingabe-Schema
{
"type": "object",
"properties": {
"species": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Espécie: 'dog'/'cachorro' ou 'cat'/'gato'.",
"title": "Species"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Nome do MUNICÍPIO por extenso, não do bairro nem abreviado: 'Belo Horizonte', não 'BH'. Acento é opcional. Se o nome for ambíguo, ou se nenhuma ONG tiver pets ali hoje, o erro explica o que fazer — leia e siga; não significa que a cidade não exista.",
"title": "City"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), apenas para desambiguar `city`. Busca só por estado NÃO é suportada: sempre envie `city` junto.",
"title": "State"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Porte: 'small'/'pequeno', 'medium'/'medio', 'large'/'grande'.",
"title": "Size"
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sexo: 'male'/'macho' ou 'female'/'femea'.",
"title": "Sex"
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida). Use a listagem de raças para ver as raças com pets hoje.",
"title": "Breed"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Nome do pet como a pessoa escreveu ('nina', 'bebe'). Acentos e maiúsculas não importam; erros de grafia geralmente NÃO são encontrados. Leia `name_match.confidence` antes de afirmar de qual pet se trata. Se a lista vier vazia, diga que não achou e pergunte como se escreve.",
"title": "Name"
},
"rescuer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Restringe a busca a UMA ONG ou protetor: o código curto do link ou o @ do Instagram, como devolvidos pela busca de ONGs. Combina com os outros filtros ('gatos filhotes desta ONG'). Sem ele a busca cobre o catálogo inteiro.",
"title": "Rescuer"
},
"age_max_months": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Idade máxima em meses. O catálogo só distingue três faixas — filhote, adulto e idoso — então sem porte 6 e 12 selecionam os mesmos pets. Os cortes mudam com espécie e porte: idoso a partir de 8 anos no cão grande, 9 no médio, 10 no pequeno e no gato.",
"title": "Age Max Months"
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "true devolve somente pets vacinados. `false` é IGNORADO: a maioria dos anúncios não informa vacinação, então filtrar por 'não vacinado' esconderia quase todo o catálogo. Para saber de um pet específico, leia `vaccinated` na ficha (null = a ONG não informou).",
"title": "Vaccinated"
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "true devolve somente pets castrados. `false` é IGNORADO pelo mesmo motivo de `vaccinated`; leia `neutered` na ficha do pet.",
"title": "Neutered"
},
"special_needs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "true devolve somente pets com cuidados especiais; false devolve somente os que não têm nenhum registrado.",
"title": "Special Needs"
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Somente pets que convivem bem com gatos.",
"title": "Good With Cats"
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Somente pets que convivem bem com cães.",
"title": "Good With Dogs"
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Somente pets que convivem bem com crianças.",
"title": "Good With Kids"
},
"include_older": {
"default": false,
"description": "Sem efeito no momento: o catálogo devolve os pets anunciados em qualquer data, independente deste parâmetro. Mantido por compatibilidade. Não prometa à pessoa que um resultado é recente — confira a data do anúncio.",
"title": "Include Older",
"type": "boolean"
},
"area": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Amplia a busca em volta de `city`: 'city'/'cidade' (padrão, só a cidade), 'neighbors'/'vizinhas' (mais as cidades que fazem divisa) ou 'radius'/'raio' (mais as cidades a até `radius_km` km). Resultados: a cidade primeiro, depois as vizinhas, depois o resto. Não combina com `name`.",
"title": "Area"
},
"radius_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Raio em km (1 a 100) para `area=radius`. Mandar só `radius_km` já significa raio.",
"title": "Radius Km"
},
"widen_if_empty": {
"default": false,
"description": "Se a área pedida não tiver pets disponíveis com os filtros, amplia a partir dela: cidades vizinhas, depois raio de 50 km, depois 100 km, parando no primeiro passo com pets. `searched_area` diz o que foi usado.",
"title": "Widen If Empty",
"type": "boolean"
},
"page": {
"default": 1,
"description": "Página, começando em 1.",
"title": "Page",
"type": "integer"
},
"limit": {
"default": 10,
"description": "Quantos resultados devolver por página. Valores acima de 24 são reduzidos a 24. Buscar por `name` devolve no máximo 5: é uma lista para confirmar, não para navegar.",
"title": "Limit",
"type": "integer"
}
},
"additionalProperties": false,
"title": "search_petsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentSearchResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentNameMatch": {
"properties": {
"query": {
"description": "O nome que foi buscado.",
"title": "Query",
"type": "string"
},
"confidence": {
"description": "'high' = é este pet: afirme direto. 'low' = NÃO afirme qual é; mostre os pets da lista e pergunte qual deles.",
"enum": [
"high",
"low"
],
"title": "Confidence",
"type": "string"
}
},
"required": [
"query",
"confidence"
],
"title": "AgentNameMatch",
"type": "object"
},
"AgentPetSummary": {
"properties": {
"short_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Código curto do pet (o mesmo de adoteca.com.br/p/{code}).",
"title": "Short Code"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Nome do pet, quando a ONG informou.",
"title": "Name"
},
"species": {
"description": "'cachorro' ou 'gato'.",
"title": "Species",
"type": "string"
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "'macho' ou 'fêmea'.",
"title": "Sex"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Porte: 'pequeno', 'médio' ou 'grande'.",
"title": "Size"
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Raça informada; a maioria é SRD (sem raça definida).",
"title": "Breed"
},
"age": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Idade legível, ex.: '6 meses', '2 anos'. Acima de um ano a idade é dada em anos inteiros; abaixo, em meses.",
"title": "Age"
},
"age_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Faixa etária: 'filhote', 'adulto' ou 'idoso'.",
"title": "Age Category"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cidade e UF onde o pet está, ex.: 'Campinas - SP'.",
"title": "City"
},
"status": {
"description": "'available', 'adopted', 'deceased' ou 'source_gone' (post original saiu do ar: pode ter sido adotado; confirme com o protetor). Nunca ofereça um pet que não esteja 'available'. 'available' só diz que ninguém sinalizou mudança: leia `days_without_update` antes de afirmar que está disponível.",
"title": "Status",
"type": "string"
},
"adoption_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Só quando status='adopted': 'announced' (a ONG anunciou) ou 'unlisted' (o post saiu do ar e a ONG confirma isso como adoção). null nos demais status.",
"title": "Adoption Evidence"
},
"photo_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Foto principal do pet.",
"title": "Photo Url"
},
"adoption_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Link da ficha do pet. SEMPRE mostre este link na resposta.",
"title": "Adoption Url"
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Link para falar com a ONG sobre este pet: abre uma página da Adoteca que leva ao post original no Instagram. Mostre este link ao indicar contato.",
"title": "Contact Url"
},
"rescuer": {
"$ref": "#/$defs/AgentRescuer",
"description": "Quem cuida do pet."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não vacinado' quando for null.",
"title": "Vaccinated"
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não castrado' quando for null.",
"title": "Neutered"
},
"dewormed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Dewormed"
},
"microchipped": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Microchipped"
},
"foster_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'aceita lar temporário' ou 'precisa de lar temporário'. Muda o que se pede à pessoa: não é adoção definitiva. null = não classificado.",
"title": "Foster Status"
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Cats"
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Dogs"
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Kids"
},
"days_without_update": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Dias desde a última notícia nova sobre este pet (publicação da ONG ou sinal de adoção). null = desfecho confirmado ou data desconhecida. Passado um mês, diga que nada novo chegou desde então e que o pet pode ou não continuar disponível; quem confirma é quem cuida dele.",
"title": "Days Without Update"
},
"published_recently": {
"anyOf": [
{
"$ref": "#/$defs/AgentPublishedRecently"
},
{
"type": "null"
}
],
"default": null,
"description": "Preenchido só na busca por nome: a Adoteca postou este pet nesta rede há pouco. Use para situar a pessoa ('o que postamos no Instagram') em vez de afirmar sem contexto."
},
"distance_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Distância em km entre o centro da cidade do pet e o da cidade buscada (0 = a própria cidade). Só vem quando a busca usou `area` ou `widen_if_empty`.",
"title": "Distance Km"
}
},
"required": [
"short_code",
"name",
"species",
"sex",
"size",
"breed",
"age",
"age_category",
"city",
"status",
"photo_url",
"adoption_url",
"rescuer"
],
"title": "AgentPetSummary",
"type": "object"
},
"AgentPublishedRecently": {
"properties": {
"platform": {
"description": "Rede onde a Adoteca postou este pet, ex.: 'Instagram'.",
"title": "Platform",
"type": "string"
},
"published_at": {
"description": "Quando a Adoteca postou.",
"format": "date-time",
"title": "Published At",
"type": "string"
}
},
"required": [
"platform",
"published_at"
],
"title": "AgentPublishedRecently",
"type": "object"
},
"AgentRescuer": {
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Nome da ONG ou protetor responsável pelo pet.",
"title": "Name"
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url.",
"title": "Instagram Url"
}
},
"required": [
"name",
"instagram_url"
],
"title": "AgentRescuer",
"type": "object"
},
"AgentSearchResponse": {
"properties": {
"total": {
"description": "Total de pets que atendem aos filtros.",
"title": "Total",
"type": "integer"
},
"page": {
"description": "Página devolvida (começa em 1).",
"title": "Page",
"type": "integer"
},
"pets": {
"description": "Os pets desta página.",
"items": {
"$ref": "#/$defs/AgentPetSummary"
},
"title": "Pets",
"type": "array"
},
"name_match": {
"anyOf": [
{
"$ref": "#/$defs/AgentNameMatch"
},
{
"type": "null"
}
],
"default": null,
"description": "Só quando a busca enviou `name`. Leia `confidence` antes de afirmar de qual pet a pessoa está falando."
},
"searched_area": {
"anyOf": [
{
"$ref": "#/$defs/AgentSearchedArea"
},
{
"type": "null"
}
],
"default": null,
"description": "A área que a busca realmente cobriu. Se `widened` for true, os pets não são da cidade pedida: diga isso antes de listá-los."
}
},
"required": [
"total",
"page",
"pets"
],
"title": "AgentSearchResponse",
"type": "object"
},
"AgentSearchedArea": {
"description": "The area the pet search actually ran — after any automatic widening.",
"properties": {
"area": {
"description": "Área usada: 'city' (só a cidade), 'neighbors' (a cidade e as que fazem divisa com ela) ou 'radius' (também as cidades a até `radius_km`).",
"enum": [
"city",
"neighbors",
"radius"
],
"title": "Area",
"type": "string"
},
"radius_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Raio em km quando `area` é 'radius'; senão null.",
"title": "Radius Km"
},
"widened": {
"description": "true quando a cidade não tinha pets e a busca foi ampliada sozinha (widen_if_empty). Diga isso à pessoa e cite a cidade de cada pet.",
"title": "Widened",
"type": "boolean"
},
"cities": {
"description": "Quantas cidades a área cobriu (0 = busca sem cidade).",
"title": "Cities",
"type": "integer"
}
},
"required": [
"area",
"radius_km",
"widened",
"cities"
],
"title": "AgentSearchedArea",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "search_petsOutput"
}🟢get_pet_details(pet_ref)
Ficha completa de um pet: saúde, cuidados, convivência e como falar com a ONG. Aceita o código curto do link ou o id devolvido pela busca de pets. Leia `status` antes de oferecer, e o `status` de cada `health_conditions` antes de falar da saúde dele.
Eingabe-Schema
{
"type": "object",
"properties": {
"pet_ref": {
"description": "Código curto do pet (ex.: 'ab12cd') ou o identificador da ficha.",
"title": "Pet Ref",
"type": "string"
}
},
"required": [
"pet_ref"
],
"additionalProperties": false,
"title": "get_pet_detailsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentPetDetail"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentContact": {
"properties": {
"kind": {
"description": "Tipo do canal, já em português: 'WhatsApp', 'Telefone', 'E-mail' ou 'Site'.",
"title": "Kind",
"type": "string"
},
"value": {
"description": "O contato em si, já validado e formatado.",
"title": "Value",
"type": "string"
}
},
"required": [
"kind",
"value"
],
"title": "AgentContact",
"type": "object"
},
"AgentHealthCondition": {
"description": "A reported condition AND its diagnostic result.\n\nThe two travel together or not at all: a NEGATIVE FIV exam is the opposite\nof an FIV diagnosis, and emitting the condition alone would have an\nassistant tell an adopter the pet is positive when the ONG said it is not.",
"properties": {
"condition": {
"description": "Condição examinada, ex.: 'FIV', 'FELV'.",
"title": "Condition",
"type": "string"
},
"status": {
"description": "Resultado: 'positivo', 'negativo', 'suspeito' ou 'tratado'. LEIA este campo antes de afirmar qualquer coisa: 'negativo' significa que o pet NÃO tem a condição.",
"title": "Status",
"type": "string"
}
},
"required": [
"condition",
"status"
],
"title": "AgentHealthCondition",
"type": "object"
},
"AgentPetDetail": {
"properties": {
"short_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Código curto do pet (o mesmo de adoteca.com.br/p/{code}).",
"title": "Short Code"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Nome do pet, quando a ONG informou.",
"title": "Name"
},
"species": {
"description": "'cachorro' ou 'gato'.",
"title": "Species",
"type": "string"
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "'macho' ou 'fêmea'.",
"title": "Sex"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Porte: 'pequeno', 'médio' ou 'grande'.",
"title": "Size"
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Raça informada; a maioria é SRD (sem raça definida).",
"title": "Breed"
},
"age": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Idade legível, ex.: '6 meses', '2 anos'. Acima de um ano a idade é dada em anos inteiros; abaixo, em meses.",
"title": "Age"
},
"age_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Faixa etária: 'filhote', 'adulto' ou 'idoso'.",
"title": "Age Category"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cidade e UF onde o pet está, ex.: 'Campinas - SP'.",
"title": "City"
},
"status": {
"description": "'available', 'adopted', 'deceased' ou 'source_gone' (post original saiu do ar: pode ter sido adotado; confirme com o protetor). Nunca ofereça um pet que não esteja 'available'. 'available' só diz que ninguém sinalizou mudança: leia `days_without_update` antes de afirmar que está disponível.",
"title": "Status",
"type": "string"
},
"adoption_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Só quando status='adopted': 'announced' (a ONG anunciou) ou 'unlisted' (o post saiu do ar e a ONG confirma isso como adoção). null nos demais status.",
"title": "Adoption Evidence"
},
"photo_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Foto principal do pet.",
"title": "Photo Url"
},
"adoption_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Link da ficha do pet. SEMPRE mostre este link na resposta.",
"title": "Adoption Url"
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Link para falar com a ONG sobre este pet: abre uma página da Adoteca que leva ao post original no Instagram. Mostre este link ao indicar contato.",
"title": "Contact Url"
},
"rescuer": {
"$ref": "#/$defs/AgentRescuer",
"description": "Quem cuida do pet."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não vacinado' quando for null.",
"title": "Vaccinated"
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não castrado' quando for null.",
"title": "Neutered"
},
"dewormed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Dewormed"
},
"microchipped": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Microchipped"
},
"foster_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'aceita lar temporário' ou 'precisa de lar temporário'. Muda o que se pede à pessoa: não é adoção definitiva. null = não classificado.",
"title": "Foster Status"
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Cats"
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Dogs"
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Kids"
},
"days_without_update": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Dias desde a última notícia nova sobre este pet (publicação da ONG ou sinal de adoção). null = desfecho confirmado ou data desconhecida. Passado um mês, diga que nada novo chegou desde então e que o pet pode ou não continuar disponível; quem confirma é quem cuida dele.",
"title": "Days Without Update"
},
"published_recently": {
"anyOf": [
{
"$ref": "#/$defs/AgentPublishedRecently"
},
{
"type": "null"
}
],
"default": null,
"description": "Preenchido só na busca por nome: a Adoteca postou este pet nesta rede há pouco. Use para situar a pessoa ('o que postamos no Instagram') em vez de afirmar sem contexto."
},
"distance_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Distância em km entre o centro da cidade do pet e o da cidade buscada (0 = a própria cidade). Só vem quando a busca usou `area` ou `widen_if_empty`.",
"title": "Distance Km"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Texto sobre o pet, transcrito do post original.",
"title": "Description"
},
"about": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Seções do 'Sobre o pet' (personalidade, rotina, cuidados).",
"title": "About"
},
"colors": {
"description": "Cores e padrões da pelagem, já em português (ex.: 'preto', 'rajada').",
"items": {
"type": "string"
},
"title": "Colors",
"type": "array"
},
"special_needs": {
"description": "Cuidados e requisitos de adoção, já em português (ex.: 'lar com telas').",
"items": {
"type": "string"
},
"title": "Special Needs",
"type": "array"
},
"disabilities": {
"description": "Deficiências informadas, já em português (ex.: 'cega', 'baixa visão').",
"items": {
"type": "string"
},
"title": "Disabilities",
"type": "array"
},
"vaccines": {
"description": "Vacinas já aplicadas, já em português (ex.: 'antirrábica', 'V10').",
"items": {
"type": "string"
},
"title": "Vaccines",
"type": "array"
},
"health_conditions": {
"description": "Condições examinadas COM o resultado de cada uma. Nunca cite uma condição sem ler o `status` — 'negativo' significa que o pet não a tem.",
"items": {
"$ref": "#/$defs/AgentHealthCondition"
},
"title": "Health Conditions",
"type": "array"
},
"contacts": {
"description": "Contatos do próprio anúncio.",
"items": {
"$ref": "#/$defs/AgentContact"
},
"title": "Contacts",
"type": "array"
},
"rescuer_contacts": {
"description": "Contatos gerais da ONG — use quando 'contacts' estiver vazio.",
"items": {
"$ref": "#/$defs/AgentContact"
},
"title": "Rescuer Contacts",
"type": "array"
},
"photos": {
"description": "Todas as fotos do pet.",
"items": {
"type": "string"
},
"title": "Photos",
"type": "array"
},
"source_post_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Post original da ONG no Instagram.",
"title": "Source Post Url"
}
},
"required": [
"short_code",
"name",
"species",
"sex",
"size",
"breed",
"age",
"age_category",
"city",
"status",
"photo_url",
"adoption_url",
"rescuer"
],
"title": "AgentPetDetail",
"type": "object"
},
"AgentPublishedRecently": {
"properties": {
"platform": {
"description": "Rede onde a Adoteca postou este pet, ex.: 'Instagram'.",
"title": "Platform",
"type": "string"
},
"published_at": {
"description": "Quando a Adoteca postou.",
"format": "date-time",
"title": "Published At",
"type": "string"
}
},
"required": [
"platform",
"published_at"
],
"title": "AgentPublishedRecently",
"type": "object"
},
"AgentRescuer": {
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Nome da ONG ou protetor responsável pelo pet.",
"title": "Name"
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url.",
"title": "Instagram Url"
}
},
"required": [
"name",
"instagram_url"
],
"title": "AgentRescuer",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "get_pet_detailsOutput"
}🟢search_similar_pets(pet_ref, limit)
Pets parecidos com UM pet específico, mesma espécie e mesma cidade — não é a busca geral do catálogo. Use quando o pet desejado já não estiver disponível. Pode vir vazia: use searchPets, nunca invente pets. Mostre o `adoption_url`. `total` é o tamanho desta lista; não há página 2.
Eingabe-Schema
{
"type": "object",
"properties": {
"pet_ref": {
"description": "Código curto do pet (ex.: 'ab12cd') ou o identificador da ficha.",
"title": "Pet Ref",
"type": "string"
},
"limit": {
"default": 6,
"description": "Quantos pets parecidos devolver, no máximo 24. Esta lista não tem páginas: não existe `page` aqui.",
"title": "Limit",
"type": "integer"
}
},
"required": [
"pet_ref"
],
"additionalProperties": false,
"title": "search_similar_petsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentSearchResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentNameMatch": {
"properties": {
"query": {
"description": "O nome que foi buscado.",
"title": "Query",
"type": "string"
},
"confidence": {
"description": "'high' = é este pet: afirme direto. 'low' = NÃO afirme qual é; mostre os pets da lista e pergunte qual deles.",
"enum": [
"high",
"low"
],
"title": "Confidence",
"type": "string"
}
},
"required": [
"query",
"confidence"
],
"title": "AgentNameMatch",
"type": "object"
},
"AgentPetSummary": {
"properties": {
"short_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Código curto do pet (o mesmo de adoteca.com.br/p/{code}).",
"title": "Short Code"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Nome do pet, quando a ONG informou.",
"title": "Name"
},
"species": {
"description": "'cachorro' ou 'gato'.",
"title": "Species",
"type": "string"
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "'macho' ou 'fêmea'.",
"title": "Sex"
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Porte: 'pequeno', 'médio' ou 'grande'.",
"title": "Size"
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Raça informada; a maioria é SRD (sem raça definida).",
"title": "Breed"
},
"age": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Idade legível, ex.: '6 meses', '2 anos'. Acima de um ano a idade é dada em anos inteiros; abaixo, em meses.",
"title": "Age"
},
"age_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Faixa etária: 'filhote', 'adulto' ou 'idoso'.",
"title": "Age Category"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cidade e UF onde o pet está, ex.: 'Campinas - SP'.",
"title": "City"
},
"status": {
"description": "'available', 'adopted', 'deceased' ou 'source_gone' (post original saiu do ar: pode ter sido adotado; confirme com o protetor). Nunca ofereça um pet que não esteja 'available'. 'available' só diz que ninguém sinalizou mudança: leia `days_without_update` antes de afirmar que está disponível.",
"title": "Status",
"type": "string"
},
"adoption_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Só quando status='adopted': 'announced' (a ONG anunciou) ou 'unlisted' (o post saiu do ar e a ONG confirma isso como adoção). null nos demais status.",
"title": "Adoption Evidence"
},
"photo_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Foto principal do pet.",
"title": "Photo Url"
},
"adoption_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Link da ficha do pet. SEMPRE mostre este link na resposta.",
"title": "Adoption Url"
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Link para falar com a ONG sobre este pet: abre uma página da Adoteca que leva ao post original no Instagram. Mostre este link ao indicar contato.",
"title": "Contact Url"
},
"rescuer": {
"$ref": "#/$defs/AgentRescuer",
"description": "Quem cuida do pet."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não vacinado' quando for null.",
"title": "Vaccinated"
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não castrado' quando for null.",
"title": "Neutered"
},
"dewormed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Dewormed"
},
"microchipped": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Microchipped"
},
"foster_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'aceita lar temporário' ou 'precisa de lar temporário'. Muda o que se pede à pessoa: não é adoção definitiva. null = não classificado.",
"title": "Foster Status"
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Cats"
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Dogs"
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null = a ONG não informou.",
"title": "Good With Kids"
},
"days_without_update": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Dias desde a última notícia nova sobre este pet (publicação da ONG ou sinal de adoção). null = desfecho confirmado ou data desconhecida. Passado um mês, diga que nada novo chegou desde então e que o pet pode ou não continuar disponível; quem confirma é quem cuida dele.",
"title": "Days Without Update"
},
"published_recently": {
"anyOf": [
{
"$ref": "#/$defs/AgentPublishedRecently"
},
{
"type": "null"
}
],
"default": null,
"description": "Preenchido só na busca por nome: a Adoteca postou este pet nesta rede há pouco. Use para situar a pessoa ('o que postamos no Instagram') em vez de afirmar sem contexto."
},
"distance_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Distância em km entre o centro da cidade do pet e o da cidade buscada (0 = a própria cidade). Só vem quando a busca usou `area` ou `widen_if_empty`.",
"title": "Distance Km"
}
},
"required": [
"short_code",
"name",
"species",
"sex",
"size",
"breed",
"age",
"age_category",
"city",
"status",
"photo_url",
"adoption_url",
"rescuer"
],
"title": "AgentPetSummary",
"type": "object"
},
"AgentPublishedRecently": {
"properties": {
"platform": {
"description": "Rede onde a Adoteca postou este pet, ex.: 'Instagram'.",
"title": "Platform",
"type": "string"
},
"published_at": {
"description": "Quando a Adoteca postou.",
"format": "date-time",
"title": "Published At",
"type": "string"
}
},
"required": [
"platform",
"published_at"
],
"title": "AgentPublishedRecently",
"type": "object"
},
"AgentRescuer": {
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Nome da ONG ou protetor responsável pelo pet.",
"title": "Name"
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url.",
"title": "Instagram Url"
}
},
"required": [
"name",
"instagram_url"
],
"title": "AgentRescuer",
"type": "object"
},
"AgentSearchResponse": {
"properties": {
"total": {
"description": "Total de pets que atendem aos filtros.",
"title": "Total",
"type": "integer"
},
"page": {
"description": "Página devolvida (começa em 1).",
"title": "Page",
"type": "integer"
},
"pets": {
"description": "Os pets desta página.",
"items": {
"$ref": "#/$defs/AgentPetSummary"
},
"title": "Pets",
"type": "array"
},
"name_match": {
"anyOf": [
{
"$ref": "#/$defs/AgentNameMatch"
},
{
"type": "null"
}
],
"default": null,
"description": "Só quando a busca enviou `name`. Leia `confidence` antes de afirmar de qual pet a pessoa está falando."
},
"searched_area": {
"anyOf": [
{
"$ref": "#/$defs/AgentSearchedArea"
},
{
"type": "null"
}
],
"default": null,
"description": "A área que a busca realmente cobriu. Se `widened` for true, os pets não são da cidade pedida: diga isso antes de listá-los."
}
},
"required": [
"total",
"page",
"pets"
],
"title": "AgentSearchResponse",
"type": "object"
},
"AgentSearchedArea": {
"description": "The area the pet search actually ran — after any automatic widening.",
"properties": {
"area": {
"description": "Área usada: 'city' (só a cidade), 'neighbors' (a cidade e as que fazem divisa com ela) ou 'radius' (também as cidades a até `radius_km`).",
"enum": [
"city",
"neighbors",
"radius"
],
"title": "Area",
"type": "string"
},
"radius_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Raio em km quando `area` é 'radius'; senão null.",
"title": "Radius Km"
},
"widened": {
"description": "true quando a cidade não tinha pets e a busca foi ampliada sozinha (widen_if_empty). Diga isso à pessoa e cite a cidade de cada pet.",
"title": "Widened",
"type": "boolean"
},
"cities": {
"description": "Quantas cidades a área cobriu (0 = busca sem cidade).",
"title": "Cities",
"type": "integer"
}
},
"required": [
"area",
"radius_km",
"widened",
"cities"
],
"title": "AgentSearchedArea",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "search_similar_petsOutput"
}🟢search_rescuers(city, state, page, limit)
Use quando perguntarem QUAIS ONGs ou protetores existem em uma cidade. Lista quem tem pets no catálogo ali, com o link de cada um. Anúncios podem ser antigos: não afirme que a ONG está ativa. Não é registro completo, e NÃO diz se alguma pode acolher — nunca afirme que tem vaga.
Eingabe-Schema
{
"type": "object",
"properties": {
"city": {
"description": "Nome do MUNICÍPIO por extenso, ou o slug devolvido pela resolução de cidade. Obrigatório: a resposta é sempre de uma cidade. Se o nome for ambíguo ou ninguém tiver pets ali hoje, o erro diz o que fazer.",
"title": "City",
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), se a pessoa informou. Opcional.",
"title": "State"
},
"page": {
"default": 1,
"description": "Página, começando em 1.",
"title": "Page",
"type": "integer"
},
"limit": {
"default": 10,
"description": "Quantos resultados devolver por página. Valores acima de 24 são reduzidos a 24. Buscar por `name` devolve no máximo 5: é uma lista para confirmar, não para navegar.",
"title": "Limit",
"type": "integer"
}
},
"required": [
"city"
],
"additionalProperties": false,
"title": "search_rescuersArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentRescuerSearchResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentRescuerSearchResponse": {
"properties": {
"total": {
"description": "Total de ONGs e protetores com pets na cidade.",
"title": "Total",
"type": "integer"
},
"page": {
"description": "Página devolvida (começa em 1).",
"title": "Page",
"type": "integer"
},
"note": {
"description": "Contexto obrigatório: a lista cobre só quem tem pets anunciados no catálogo, de qualquer data — não é um registro de todas as ONGs da cidade, nem garantia de que estejam ativas hoje.",
"title": "Note",
"type": "string"
},
"rescuers": {
"description": "As ONGs desta página.",
"items": {
"$ref": "#/$defs/AgentRescuerSummary"
},
"title": "Rescuers",
"type": "array"
}
},
"required": [
"total",
"page",
"note",
"rescuers"
],
"title": "AgentRescuerSearchResponse",
"type": "object"
},
"AgentRescuerSummary": {
"properties": {
"short_code": {
"description": "Código curto da ONG (o mesmo de adoteca.com.br/o/{code}).",
"title": "Short Code",
"type": "string"
},
"name": {
"description": "Nome da ONG ou protetor.",
"title": "Name",
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cidade base, ex.: 'Niterói - RJ'.",
"title": "City"
},
"available_count": {
"description": "Pets com anúncio ativo para adoção. O anúncio pode ser antigo — não prometa à pessoa que é recente.",
"title": "Available Count",
"type": "integer"
},
"adopted_count": {
"description": "Pets já adotados através dos anúncios.",
"title": "Adopted Count",
"type": "integer"
},
"profile_url": {
"description": "Página da ONG na Adoteca, com todos os pets e formas de ajudar. SEMPRE mostre este link ao falar da ONG.",
"title": "Profile Url",
"type": "string"
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url.",
"title": "Instagram Url"
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Link para falar com a ONG: abre uma página da Adoteca que leva ao Instagram dela. Mostre este link ao indicar contato.",
"title": "Contact Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Foto de perfil da ONG.",
"title": "Avatar Url"
}
},
"required": [
"short_code",
"name",
"city",
"available_count",
"adopted_count",
"profile_url",
"instagram_url",
"avatar_url"
],
"title": "AgentRescuerSummary",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "search_rescuersOutput"
}🟢get_rescuer_details(rescuer_ref)
Ficha de uma ONG ou protetor: cidades atendidas, contatos, site e página de doação. Aceita o código curto do link ou o @ do Instagram, devolvidos pela busca de ONGs. Para doações, mostre `donation_url` ou `profile_url` — nunca peça nem repasse chave PIX.
Eingabe-Schema
{
"type": "object",
"properties": {
"rescuer_ref": {
"description": "Código curto da ONG (ex.: 'ab12cd', o mesmo de adoteca.com.br/o/{code}) ou o @ do Instagram dela, sem arroba.",
"title": "Rescuer Ref",
"type": "string"
}
},
"required": [
"rescuer_ref"
],
"additionalProperties": false,
"title": "get_rescuer_detailsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentRescuerDetail"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentContact": {
"properties": {
"kind": {
"description": "Tipo do canal, já em português: 'WhatsApp', 'Telefone', 'E-mail' ou 'Site'.",
"title": "Kind",
"type": "string"
},
"value": {
"description": "O contato em si, já validado e formatado.",
"title": "Value",
"type": "string"
}
},
"required": [
"kind",
"value"
],
"title": "AgentContact",
"type": "object"
},
"AgentRescuerDetail": {
"description": "The summary PLUS the fields a person needs before contacting an ONG.\n\nDeliberately NOT everything `account_to_detail` carries: `pix_key` and\n`like_count` are excluded (as is `display_name`, which only the admin\nmapper emits) — see `agent_rescuer_detail`.",
"properties": {
"short_code": {
"description": "Código curto da ONG (o mesmo de adoteca.com.br/o/{code}).",
"title": "Short Code",
"type": "string"
},
"name": {
"description": "Nome da ONG ou protetor.",
"title": "Name",
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Cidade base, ex.: 'Niterói - RJ'.",
"title": "City"
},
"available_count": {
"description": "Pets com anúncio ativo para adoção. O anúncio pode ser antigo — não prometa à pessoa que é recente.",
"title": "Available Count",
"type": "integer"
},
"adopted_count": {
"description": "Pets já adotados através dos anúncios.",
"title": "Adopted Count",
"type": "integer"
},
"profile_url": {
"description": "Página da ONG na Adoteca, com todos os pets e formas de ajudar. SEMPRE mostre este link ao falar da ONG.",
"title": "Profile Url",
"type": "string"
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url.",
"title": "Instagram Url"
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Link para falar com a ONG: abre uma página da Adoteca que leva ao Instagram dela. Mostre este link ao indicar contato.",
"title": "Contact Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Foto de perfil da ONG.",
"title": "Avatar Url"
},
"about": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Parágrafo de apresentação da ONG.",
"title": "About"
},
"founding_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Ano de fundação, se informado.",
"title": "Founding Year"
},
"cities": {
"description": "Cidades atendidas, ex.: 'Niterói - RJ'.",
"items": {
"type": "string"
},
"title": "Cities",
"type": "array"
},
"website_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Site oficial.",
"title": "Website Url"
},
"cnpj": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "CNPJ da ONG, quando é uma entidade registrada. É um sinal de confiança, não um dado administrativo: antes de doar, a pessoa deve conferir se o nome que aparece na tela do PIX bate com este CNPJ. 14 dígitos, sem pontuação.",
"title": "Cnpj"
},
"donation_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Página de doação/vaquinha da ONG. Para doar por PIX, direcione a pessoa ao profile_url — nunca repasse chaves.",
"title": "Donation Url"
},
"contacts": {
"description": "Canais de contato da ONG.",
"items": {
"$ref": "#/$defs/AgentContact"
},
"title": "Contacts",
"type": "array"
},
"social_profiles": {
"description": "Perfis da ONG nas redes.",
"items": {
"$ref": "#/$defs/AgentSocialProfile"
},
"title": "Social Profiles",
"type": "array"
}
},
"required": [
"short_code",
"name",
"city",
"available_count",
"adopted_count",
"profile_url",
"instagram_url",
"avatar_url"
],
"title": "AgentRescuerDetail",
"type": "object"
},
"AgentSocialProfile": {
"properties": {
"platform": {
"description": "Rede social, já pronta para mostrar, ex.: 'Instagram', 'TikTok'.",
"title": "Platform",
"type": "string"
},
"url": {
"description": "Link do perfil.",
"title": "Url",
"type": "string"
}
},
"required": [
"platform",
"url"
],
"title": "AgentSocialProfile",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "get_rescuer_detailsOutput"
}🟢search_cities(city, state)
Converte o nome de uma cidade (com ou sem acento, com erro de grafia) no slug oficial do catálogo. Use antes das outras buscas quando a pessoa citar uma cidade. Se `ambiguous` for true, escolha pelo contexto ou pergunte; nunca chute. Para os números da cidade, use as estatísticas.
Eingabe-Schema
{
"type": "object",
"properties": {
"city": {
"description": "Nome do município como a pessoa escreveu, ex.: 'sao paulo', 'Cachoeirinha'.",
"title": "City",
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), se a pessoa informou. Opcional.",
"title": "State"
}
},
"required": [
"city"
],
"additionalProperties": false,
"title": "search_citiesArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentFindCityResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentCityMatch": {
"properties": {
"slug": {
"description": "Slug oficial do município no catálogo, ex.: 'santa-luzia-mg'.",
"title": "Slug",
"type": "string"
},
"name": {
"description": "Nome do município.",
"title": "Name",
"type": "string"
},
"state": {
"description": "Sigla da UF, ex.: 'MG'.",
"title": "State",
"type": "string"
},
"pet_count": {
"description": "Pets já anunciados nessa cidade, de qualquer data. Inclui os já adotados e anúncios antigos, então pode ser bem maior que o número disponível agora. Não prometa à pessoa que são recentes.",
"title": "Pet Count",
"type": "integer"
},
"rescuer_count": {
"description": "ONGs e protetores com pets anunciados nessa cidade.",
"title": "Rescuer Count",
"type": "integer"
}
},
"required": [
"slug",
"name",
"state",
"pet_count",
"rescuer_count"
],
"title": "AgentCityMatch",
"type": "object"
},
"AgentFindCityResponse": {
"properties": {
"found": {
"description": "Se alguma cidade com esse nome está no catálogo. Veja `pet_count` de cada uma.",
"title": "Found",
"type": "boolean"
},
"ambiguous": {
"description": "true = mais de uma cidade corresponde. Escolha pelo contexto da conversa ou pergunte à pessoa; NUNCA chute.",
"title": "Ambiguous",
"type": "boolean"
},
"cities": {
"description": "Cidades correspondentes, mais pets primeiro.",
"items": {
"$ref": "#/$defs/AgentCityMatch"
},
"title": "Cities",
"type": "array"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Quando presente, explica o resultado: nenhuma cidade encontrada, ou candidatas demais e a lista foi cortada. Leia e siga.",
"title": "Note"
}
},
"required": [
"found",
"ambiguous",
"cities"
],
"title": "AgentFindCityResponse",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "search_citiesOutput"
}🟢get_city_stats(city, state)
Números do catálogo em UMA cidade já resolvida: quantos pets, por espécie, porte e idade, entradas em 24h, adoções, quantas ONGs e as raças mais comuns. Use para 'quantos pets tem em X?'. Não devolve pets, não resolve o nome da cidade e não diz QUAIS são as ONGs — para isso, use a busca de ONGs.
Eingabe-Schema
{
"type": "object",
"properties": {
"city": {
"description": "Nome do MUNICÍPIO por extenso, ou o slug devolvido pela resolução de cidade. Obrigatório: a resposta é sempre de uma cidade. Se o nome for ambíguo ou ninguém tiver pets ali hoje, o erro diz o que fazer.",
"title": "City",
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), se a pessoa informou. Opcional.",
"title": "State"
}
},
"required": [
"city"
],
"additionalProperties": false,
"title": "get_city_statsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentCityStats"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentBreedCount": {
"description": "A breed and how many of the city's pets carry it.\n\nNo `slug`, unlike `AgentBreed`: `search_pets(breed=...)` takes the NAME too\n(Breed values are the accent-stripped pt-BR names, and `parse_breed` aliases\nthe one name this surface invents), so a second identifier would only be\nsomething else to keep in sync.",
"properties": {
"name": {
"description": "Nome da raça. Pode ser enviado em `breed` na busca de pets.",
"title": "Name",
"type": "string"
},
"count": {
"description": "Pets dessa raça entre os contados em `pet_count`.",
"title": "Count",
"type": "integer"
},
"by_species": {
"additionalProperties": {
"type": "integer"
},
"description": "Quantos desses são de cada espécie: chaves 'cachorro' e 'gato', e somam `count`. Uma raça pode aparecer nas duas — SRD (sem raça definida) aparece. Se a pessoa perguntou por uma espécie só, leia daqui: `name` e `count` juntam as duas.",
"title": "By Species",
"type": "object"
}
},
"required": [
"name",
"count"
],
"title": "AgentBreedCount",
"type": "object"
},
"AgentCityStats": {
"description": "Aggregate counts for ONE city. Deliberately carries no pets and no\nneighbouring cities — the pet search and the city lookup answer those.",
"properties": {
"city": {
"description": "Cidade e UF, ex.: 'Campinas - SP'.",
"title": "City",
"type": "string"
},
"pet_count": {
"description": "Pets já anunciados nessa cidade, de qualquer data. Inclui os já adotados e anúncios antigos, então pode ser bem maior que o número disponível agora. Não prometa à pessoa que são recentes.",
"title": "Pet Count",
"type": "integer"
},
"available_count": {
"description": "Pets dessa cidade disponíveis para adoção agora. É este o número para dizer quantos pets a cidade TEM — `pet_count` e os campos por espécie, idade, porte e raça contam também os já adotados e os anúncios antigos, então são sempre maiores ou iguais a este.",
"title": "Available Count",
"type": "integer"
},
"total_ever": {
"description": "Pets já anunciados nessa cidade desde o início do catálogo, sem recorte de tempo. É a base dos campos por espécie, idade e porte, do `rank` e do `national_pct` — todos históricos. `pet_count` carrega hoje o mesmo número: este retorno não tem um recorte de 'anunciado agora'.",
"title": "Total Ever",
"type": "integer"
},
"by_species": {
"additionalProperties": {
"type": "integer"
},
"description": "Quantos por espécie: chaves 'cachorro' e 'gato'. Somam `total_ever`.",
"title": "By Species",
"type": "object"
},
"by_age": {
"additionalProperties": {
"type": "integer"
},
"description": "Quantos por faixa etária: 'filhote', 'adulto', 'idoso'. Pets sem idade informada ficam de fora, então pode somar menos que `total_ever`.",
"title": "By Age",
"type": "object"
},
"by_size": {
"additionalProperties": {
"type": "integer"
},
"description": "Quantos por porte: 'pequeno', 'médio', 'grande'. Pets sem porte informado ficam de fora, então pode somar menos que `total_ever`.",
"title": "By Size",
"type": "object"
},
"new_last_24h": {
"description": "Pets que entraram no catálogo dessa cidade em 24h.",
"title": "New Last 24H",
"type": "integer"
},
"adopted_total": {
"description": "Adoções já registradas nessa cidade, desde o início do catálogo.",
"title": "Adopted Total",
"type": "integer"
},
"rescuer_count": {
"description": "ONGs e protetores com pets anunciados nessa cidade.",
"title": "Rescuer Count",
"type": "integer"
},
"rank": {
"description": "Posição da cidade no ranking nacional por `total_ever` (1 = 1º).",
"title": "Rank",
"type": "integer"
},
"national_pct": {
"description": "Percentual de todo o catálogo histórico que está nessa cidade, ex.: 2.4. Calculado sobre `total_ever`.",
"title": "National Pct",
"type": "number"
},
"top_breeds": {
"description": "As raças mais comuns na cidade em todo o histórico, as mais numerosas primeiro.",
"items": {
"$ref": "#/$defs/AgentBreedCount"
},
"title": "Top Breeds",
"type": "array"
}
},
"required": [
"city",
"pet_count",
"available_count",
"total_ever",
"by_species",
"by_age",
"by_size",
"new_last_24h",
"adopted_total",
"rescuer_count",
"rank",
"national_pct",
"top_breeds"
],
"title": "AgentCityStats",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "get_city_statsOutput"
}🟢list_breeds(species)
Raças com pets no catálogo hoje, mais comuns primeiro, com o slug para enviar em `breed`. Use antes de filtrar por raça e quando perguntarem quais raças existem. A maioria do catálogo é SRD (sem raça definida): ofereça SRD em vez de dizer que não há pets.
Eingabe-Schema
{
"type": "object",
"properties": {
"species": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Espécie: 'dog'/'cachorro' ou 'cat'/'gato'.",
"title": "Species"
}
},
"additionalProperties": false,
"title": "list_breedsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentBreedsResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentBreed": {
"properties": {
"slug": {
"description": "Envie este valor em `breed` na busca de pets, ex.: 'pastor-alemao'.",
"title": "Slug",
"type": "string"
},
"name": {
"description": "Nome da raça para mostrar à pessoa.",
"title": "Name",
"type": "string"
},
"species": {
"description": "'cachorro' ou 'gato'.",
"title": "Species",
"type": "string"
},
"count": {
"description": "Pets dessa raça já anunciados, somando o Brasil inteiro. Inclui os já adotados e anúncios antigos, então pode ser bem maior que o número disponível agora — e não diz se há algum na cidade da pessoa. Não prometa que são recentes.",
"title": "Count",
"type": "integer"
}
},
"required": [
"slug",
"name",
"species",
"count"
],
"title": "AgentBreed",
"type": "object"
},
"AgentBreedsResponse": {
"properties": {
"breeds": {
"description": "As raças com pets no catálogo, as mais comuns primeiro. UMA LINHA POR RAÇA E ESPÉCIE: uma raça que existe nas duas aparece duas vezes, com o mesmo `slug` e `species` diferentes — não some as duas. SRD (sem raça definida) lidera: é a maioria do catálogo.",
"items": {
"$ref": "#/$defs/AgentBreed"
},
"title": "Breeds",
"type": "array"
}
},
"required": [
"breeds"
],
"title": "AgentBreedsResponse",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "list_breedsOutput"
}🟢search_guides(query)
Guias da Adoteca sobre adoção, saúde e cuidados especiais (FIV, FeLV, leishmaniose, pet surdo, custos) e ajuda sobre como o site funciona. Use para dúvidas que não são busca de pets. Responda com base no `summary`, mostre o `url` e, se a lista vier vazia, diga que não temos guia sobre isso.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"description": "A dúvida da pessoa, como ela escreveu, ex.: 'meu gato tem FIV' ou 'quanto custa ter um cachorro'. Acentos e erros de grafia são tolerados.",
"title": "Query",
"type": "string"
}
},
"required": [
"query"
],
"additionalProperties": false,
"title": "search_guidesArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentGuidesResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentGuideResult": {
"description": "One guide article or site-help answer matched by searchGuides.",
"properties": {
"title": {
"description": "Título do guia ou da resposta de ajuda.",
"title": "Title",
"type": "string"
},
"summary": {
"description": "Resumo do conteúdo, escrito para ser lido à pessoa. Responda com base nele e não invente detalhes que não estejam aqui.",
"title": "Summary",
"type": "string"
},
"url": {
"description": "Link do guia no site. SEMPRE mostre este link na resposta.",
"title": "Url",
"type": "string"
}
},
"required": [
"title",
"summary",
"url"
],
"title": "AgentGuideResult",
"type": "object"
},
"AgentGuidesResponse": {
"properties": {
"results": {
"description": "Guias mais relevantes, os melhores primeiro (no máximo 3). Lista vazia = não temos guia sobre isso; diga que não sabe.",
"items": {
"$ref": "#/$defs/AgentGuideResult"
},
"title": "Results",
"type": "array"
}
},
"required": [
"results"
],
"title": "AgentGuidesResponse",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "search_guidesOutput"
}🟢get_catalog_link(species, city, state, size, sex, ...)
Monta o link do catálogo com os filtros pedidos e confirma que existem pets neles. Use quando a pessoa quiser ver a lista no site. Se `url` vier null, não há link: leia `note` e ofereça tirar um filtro. Nunca escreva um link de catálogo à mão.
Eingabe-Schema
{
"type": "object",
"properties": {
"species": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Espécie: 'dog'/'cachorro' ou 'cat'/'gato'.",
"title": "Species"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Nome do MUNICÍPIO por extenso, não do bairro nem abreviado: 'Belo Horizonte', não 'BH'. Acento é opcional. Se o nome for ambíguo, ou se nenhuma ONG tiver pets ali hoje, o erro explica o que fazer — leia e siga; não significa que a cidade não exista.",
"title": "City"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), apenas para desambiguar `city`. Busca só por estado NÃO é suportada: sempre envie `city` junto.",
"title": "State"
},
"size": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Portes, um ou mais: 'small'/'pequeno', 'medium'/'medio', 'large'/'grande'. Envie os dois quando a pessoa aceitar os dois.",
"title": "Size"
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Sexo: 'male'/'macho' ou 'female'/'femea'.",
"title": "Sex"
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida). Use a listagem de raças para ver as raças com pets hoje.",
"title": "Breed"
},
"age": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Faixa etária, uma só: 'filhote', 'adulto' ou 'idoso'. São as três faixas que o catálogo distingue; os cortes mudam com espécie e porte (idoso a partir de 8 anos no cão grande, 9 no médio, 10 no pequeno e no gato).",
"title": "Age"
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "true devolve somente pets vacinados. `false` é IGNORADO: a maioria dos anúncios não informa vacinação, então filtrar por 'não vacinado' esconderia quase todo o catálogo. Para saber de um pet específico, leia `vaccinated` na ficha (null = a ONG não informou).",
"title": "Vaccinated"
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "true devolve somente pets castrados. `false` é IGNORADO pelo mesmo motivo de `vaccinated`; leia `neutered` na ficha do pet.",
"title": "Neutered"
},
"special_needs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "true monta o link só com pets com cuidados especiais. `false` é IGNORADO: o catálogo não tem o filtro inverso.",
"title": "Special Needs"
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Somente pets que convivem bem com gatos.",
"title": "Good With Cats"
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Somente pets que convivem bem com cães.",
"title": "Good With Dogs"
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Somente pets que convivem bem com crianças.",
"title": "Good With Kids"
},
"sort": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Ordem da página: 'recentes' (padrão, os anúncios mais novos primeiro) ou 'disponiveis' (os que ainda estão para adoção primeiro, empurrando os já adotados para o fim).",
"title": "Sort"
}
},
"additionalProperties": false,
"title": "get_catalog_linkArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentLinkResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
},
"required": [
"result"
],
"$defs": {
"AgentLinkResponse": {
"description": "A catalog link that was CONFIRMED to have pets, or no link at all.",
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Link do catálogo com esses filtros. null = nenhum pet corresponde hoje; nesse caso leia `note` e NUNCA escreva um link à mão.",
"title": "Url"
},
"total": {
"description": "Quantos pets essa página do catálogo mostra hoje.",
"title": "Total",
"type": "integer"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Quando presente, explica por que não há link. Leia e siga.",
"title": "Note"
}
},
"required": [
"url",
"total"
],
"title": "AgentLinkResponse",
"type": "object"
},
"AgentToolError": {
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one.",
"properties": {
"error": {
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto.",
"title": "Error",
"type": "string"
}
},
"required": [
"error"
],
"title": "AgentToolError",
"type": "object"
}
},
"title": "get_catalog_linkOutput"
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet10 Tools
verifiziertVersion nicht aufgezeichnet10 Tools